Laravel项目中简单PHP代码无法执行的问题求助

一、先解决PHP代码不执行的核心问题 #

浏览器本身不解析PHP代码，必须通过Web服务器执行后返回结果，直接双击PHP文件打开肯定不行，按以下步骤排查：

1. 通过正确的服务器URL访问

   • 用Laravel自带服务器：在项目根目录打开终端，运行php artisan serve，启动后访问http://localhost:8000开头的地址。注意：Laravel的请求入口是public目录，所以测试文件要么放到public下（比如public/test01.php，访问http://localhost:8000/test01.php），要么通过Laravel路由来访问，不要直接放项目根目录。
   • 用XAMPP/WAMP等集成环境：把Laravel项目放到集成环境的网站根目录（比如XAMPP的htdocs），通过http://localhost/你的项目名/public/test01.php访问。

2. 验证PHP环境是否正常
   新建phpinfo.php文件，内容为<?php phpinfo(); ?>，放到服务器可访问的目录，通过URL访问。如果能看到PHP配置信息，说明环境正常；如果看不到，检查：

   • PHP是否正确安装，环境变量是否配置
   • Web服务器是否启用了PHP解析模块（比如Apache的httpd.conf里是否加载了php_module，Nginx是否配置了PHP-FPM转发）

3. Laravel项目中测试代码的正确姿势
   不要在根目录放独立PHP文件，遵循Laravel的架构：

   • Blade视图测试：在resources/views新建test.blade.php，内容：

     <h1>测试标题</h1>
     @php
         echo '原生PHP执行结果';
     @endphp
     {{ 'Blade语法输出内容' }}
     

     然后在routes/web.php添加路由：Route::get('/test', fn() => view('test'));，启动服务器后访问http://localhost:8000/test。
   • 路由直接测试：在routes/web.php写：

     Route::get('/test', function () {
         echo '<h1>测试</h1>';
         var_dump('PHP代码执行成功');
     });
     

     访问对应URL即可看到结果。

二、VS Code配置Laravel的XDebug调试 #

先确保XDebug安装配置正确，再设置VS Code：

1. 安装并配置XDebug

   • 打开phpinfo.php，搜索XDebug确认扩展已加载。如果没有，下载对应PHP版本的XDebug扩展（注意匹配PHP版本、线程安全TS/NTS），放到PHP的ext目录，修改php.ini添加：

     zend_extension=xdebug
     xdebug.mode=debug
     xdebug.start_with_request=yes
     xdebug.client_host=127.0.0.1
     xdebug.client_port=9003
     

   • 重启Web服务器或php artisan serve（重启后才会读取新配置）。

2. VS Code调试配置

   • 安装「PHP Debug」插件（作者Felix Becker）。
   • 打开运行面板（Ctrl+Shift+D），点击「创建launch.json文件」，选择PHP环境，生成配置后确保内容如下：

     {
         "version": "0.2.0",
         "configurations": [
             {
                 "name": "Listen for Xdebug",
                 "type": "php",
                 "request": "launch",
                 "port": 9003
             }
         ]
     }
     

   • 调试控制器：在edit()或update()方法内打断点，启动php artisan serve，然后在VS Code里启动「Listen for Xdebug」会话，浏览器访问对应路由（比如/posts/1/edit），VS Code就会命中断点，开始调试。

内容的提问来源于stack exchange，提问作者Henry