在 vscode 中配置 php 开发环境
1 PHP
官网地址:PHP
界面:
2 下载
官网下载地址:Download PHP
3 安装
① 按照下图指示下载 php zip包。
② 解压到想要安装 php 的位置(注意先双击打开压缩包,看下有没有根目录)。
如下图,打开后没有根目录,不要直接解压,不然文件就混在一起了。
这里建议新建一个根目录再解压(或者直接右键选择“解压到xxx”),如下图所示。
4 配置环境变量
① 打开 php 安装目录,按下图复制地址。
② 右击“我的电脑” →“属性” →“高级系统设置”→“环境变量” (或者 直接按 win + s 搜索“高级系统设置” ,然后点击“查看高级系统设置”→“环境变量”),打开“环境变量”对话框,如下图所示。
③ 在第②步打开的“环境变量”对话框中双击修改“系统变量”中的 path,添加第 ① 步所复制的路径。
注意:环境变量配置完别忘记点击确定(一路点击“确定”直到“系统属性”对话框消失)。
④ 测试:在 cmd 中输入
php -v
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");
?>
② 使用phpinfo()
检查 php 信息,运行如下代码。
<?php
phpinfo()
?>
③ 查找对应模块,如下图只有一条记录,表示该模块未开启。
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
② (没有 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
7.2 配置
① 下载 PHP Debug 插件。
② 点击 文件 → 首选项 → 设置,输入 php,并点击“在 settings.json 中编辑”,如下图所示。
然后添加如下配置(记得修改路径)。
"php.validate.executablePath": "D:/software/php-8.2.10-Win32-vs16-x64/php.exe"
③ 设置断点调试,如下图所示。
最后推荐一些 PHP 的插件,以及其他常用VSCode 必备插件推荐。