在 VSCode 中配置 PHP 开发环境
作者:mmseoamin日期:2023-12-21

在 VSCode 中配置 PHP 开发环境

1 PHP

官网地址:PHP

界面:

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第1张

2 下载

官网下载地址:Download PHP

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第2张

3 安装

① 按照下图指示下载 php zip包。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第3张

② 解压到想要安装 php 的位置(注意先双击打开压缩包,看下有没有根目录)。

如下图,打开后没有根目录,不要直接解压,不然文件就混在一起了。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第4张

这里建议新建一个根目录再解压(或者直接右键选择“解压到xxx”),如下图所示。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第5张

4 配置环境变量

① 打开 php 安装目录,按下图复制地址。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第6张

② 右击“我的电脑” →“属性” →“高级系统设置”→“环境变量” (或者 直接按 win + s 搜索“高级系统设置” ,然后点击“查看高级系统设置”→“环境变量”),打开“环境变量”对话框,如下图所示。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第7张

③ 在第②步打开的“环境变量”对话框中双击修改“系统变量”中的 path,添加第 ① 步所复制的路径。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第8张

注意:环境变量配置完别忘记点击确定(一路点击“确定”直到“系统属性”对话框消失)。

④ 测试:在 cmd 中输入

php -v

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第9张

5 在 VSCode 中配置 PHP

① 安装插件 PHP Server(如下图所示),这个插件可以让 .php 文件直接右击运行于浏览器中,不需要借助于 xampp 的 Apache。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第10张

注意:该插件用于个人测试及小网站的开发是没有任何问题的,不过大型应用还是要配合 Nginx 或 Apache 以达到最高效率。

② 随便创建一个测试文件夹,用 vscode 打开,新建个 php 文件,输入代码,右击选择“PHP Server: Serve project”选项,如下图所示。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第11张

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第12张

注意:如果运行后提示“PHP not found”,请检查环境变量地址是否配置正确。

③ 补充:修改 PHP Server 默认端口号

PHP Server 默认端口号为 3000,这是可以修改的。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第13张

修改完毕重启服务!

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第14张

注意:这里我们在浏览器中输入的是 http://localhost:80/index.php,然而在浏览器地址中为什么显示的却是 localhost/index.php 呢?这是因为浏览网页服务默认的端口号HTTP是80,HTTPS是443,如果设置端口号一致会自动省略。另外如果 .php 文件为 index 命名,则只需要在浏览器输入 localhost 即可,因为服务器会默认访问index.php 这个页面。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第15张

6 开启 php 模块及错误检查

例如:当使用 php 连接 mysql 的时候,如果未配置相应模块,会出现如下图情况。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第16张

接下来将以 mysqli 为例,描述如何检查错误与开启模块。

6.1 错误检查方法

① 查看代码是否有书写错误。


② 使用phpinfo()检查 php 信息,运行如下代码。


③ 查找对应模块,如下图只有一条记录,表示该模块未开启。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第17张

6.2 开启模块

① 打开 php 根目录下的 ext 文件夹,检查是否存在 php_mysqli.dll 文件(没有该文件可自行下载添加)。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第18张

② 打开 php.ini 文件,搜索找到;extension=mysqli并修改为extension=mysqli(或者直接去掉前边的分号),如下图所示。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第19张

然后搜索找到;extension_dir = "ext",将其修改为extension_dir = "ext",如下图所示。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第20张

修改完毕,保存并关闭。

③ 重启 php 服务,再次操作 6.1 中的第 ② 和第 ③ 步,显示如下图结果表示开启模块成功。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第21张

7 Xdebug 下载与配置(按需配置)

7.1 下载

Xdebug 要下载与 php 对应的版本,我们下载的 php 版本为 8.2.10,而且是 thread safe 版本,对应的是带 TS 的版本。

下载地址:Xdebug: Downloads(网址打不开请更换网络或使用代理)

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第22张

把下载的 php_xdebug-3.3.0alpha2-8.2-vs16-x86_64.dll 文件,复制到 php 根目录下的 ext 目录中,然后在 php 根目录下找到 php.ini 文件,有如下两种情况。

① (有 php.ini 文件)直接在 php 目录的 php.ini 的文件末尾添加如下配置即可(记得修改路径)。

[xdebug]
zend_extension="D:\software\php-8.2.10-Win32-vs16-x64\ext\php_xdebug-3.3.0alpha2-8.2-vs16-x86_64.dll"
xdebug.remote_enable = 1
xdebug.remote_autostart = 1
xdebug.remote_port = 9001

② (没有 php.ini 文件)这里我们可以在 php 根目录下找到 php.ini-development (开发环境用)与 php.ini-production(生产环境用)两个文件。这里虽然没有 php.ini 文件,而 php 还是会去加载 php.ini 作为配置文件的。我们只要选择其中一个,把它备份,然后重命名为php.ini,最后加入自己个性化的配置即可。这里建议将 php.ini-development 文件备份重命名为 php.ini 就行,如下图所示:

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第23张

最后将如下配置添加到 php.ini 文件末尾即可(记得修改路径)。

[xdebug]
zend_extension="D:\software\php-8.2.10-Win32-vs16-x64\ext\php_xdebug-3.3.0alpha2-8.2-vs16-x86_64.dll"
xdebug.remote_enable = 1
xdebug.remote_autostart = 1
xdebug.remote_port = 9001

7.2 配置

① 下载 PHP Debug 插件。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第24张

② 点击 文件 → 首选项 → 设置,输入 php,并点击“在 settings.json 中编辑”,如下图所示。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第25张

然后添加如下配置(记得修改路径)。

"php.validate.executablePath": "D:/software/php-8.2.10-Win32-vs16-x64/php.exe"

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第26张

③ 设置断点调试,如下图所示。

在 VSCode 中配置 PHP 开发环境,在这里插入图片描述,第27张

最后推荐一些 PHP 的插件,以及其他常用VSCode 必备插件推荐。