在 VSCode 中配置 PHP 开发环境

在 VSCode 中配置 PHP 开发环境

1 PHP

官网地址：PHP

界面：

2 下载

官网下载地址：Download PHP

3 安装

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

② 解压到想要安装 php 的位置（注意先双击打开压缩包，看下有没有根目录）。
如下图，打开后没有根目录，不要直接解压，不然文件就混在一起了。

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

4 配置环境变量

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

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

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

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

④ 测试：在 cmd 中输入

php -v

• 1

5 在 VSCode 中配置 PHP

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

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

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

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

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

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

修改完毕重启服务！

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

6 开启 php 模块及错误检查

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

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

6.1 错误检查方法

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

<?php // 连接 MySQL 数据库 $conn = mysqli_connect("localhost", "root", "","goods") or die("连接数据库服务失败！".mysqli_error()); // 设置 utf8 编码格式 mysqli_query($conn, "set names utf8"); ?>

• 1
• 2
• 3
• 4
• 5
• 6

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

<?php phpinfo() ?>

• 1
• 2
• 3

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

6.2 开启模块

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

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

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

修改完毕，保存并关闭。
③ 重启 php 服务，再次操作 6.1 中的第 ② 和第 ③ 步，显示如下图结果表示开启模块成功。

7 Xdebug 下载与配置（按需配置）

7.1 下载

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

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

把下载的 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

• 1
• 2
• 3
• 4
• 5

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

最后将如下配置添加到 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

• 1
• 2
• 3
• 4
• 5

7.2 配置

① 下载 PHP Debug 插件。

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

然后添加如下配置（记得修改路径）。

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

• 1

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

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