写给愿意动手的 PHP 开发者
PHP学习网 PHP学习网
公告PHP学习网为公益性网站,致力于为广大PHP爱好者服务
首页/ PHP 教程/ 基础入门/ 用 phpstudy 搭起第一个 PHP 运行环境
基础入门 phpstudy环境搭建PHP安装教程

用 phpstudy 搭起第一个 PHP 运行环境

Windows 上装 phpstudy(小皮面板),选对 PHP 版本,配好站点根目录,十分钟跑通第一个页面。附带启动失败与 403/404 的排查顺序。

很多人学 PHP 卡在第一步:装完 phpstudy,浏览器打开还是 404 或者一片空白。问题通常不在代码,而在「站点根目录指向哪」和「PHP 版本选了什么」这两件事上。这篇按顺序走一遍。

装哪个版本,怎么装

phpstudy 现在叫「小皮面板」,Windows 版是集成环境,Apache/Nginx、PHP、MySQL 都打包好了。下载后一路下一步即可,安装路径不要带中文和空格,这一点很关键——带空格的路径会让部分扩展加载失败。

安装完成后打开面板,先只启动两个服务:Apache(或 Nginx)和 MySQL。MySQL 如果 3306 端口被占用,面板会提示启动失败,改端口或者先停掉占用它的服务。

三个必须确认的设置

  1. PHP 版本:在「软件管理」里看已安装的版本。老项目用 7.4,新项目建议 8.1 或 8.2。不要同时装五六个版本,切换时容易忘了切回来。
  2. 站点根目录:「网站」→「创建网站」,根目录指向你放代码的文件夹,比如 D:/code/php-demo。不要直接指向 phpstudy 安装目录下的 WWW,那是内置示例。
  3. 端口:默认 80。如果本机装了 IIS 或者别的面板,80 会被占用,改成 8080,之后访问就要带端口。

跑通第一个页面

在站点根目录新建 index.php,写入下面这段,然后在浏览器打开 http://localhost/ :

PHP
<?php
echo 'PHP 版本:' . PHP_VERSION . '<br>';
echo '当前时间:' . date('Y-m-d H:i:s') . '<br>';
echo '配置文件:' . php_ini_loaded_file();

如果页面显示了版本号和时间,环境就通了。第三行会告诉你当前用的是哪个 php.ini,改配置时别改错文件——phpstudy 每个 PHP 版本都有独立的 ini。

打不开时的排查顺序

  • 先看服务是否真的在跑:面板上的状态可能是「已启动」,但进程已经挂了,去任务管理器确认。
  • 再看端口:命令行执行 netstat -ano | findstr :80,看被谁占用。
  • 然后看根目录:访问出现 403 多半是目录里没有 index 文件,或者目录权限不对;404 多半是站点没绑定到你想的目录。
  • 最后看 hosts:如果你用自定义域名,hosts 里要有 127.0.0.1 你的域名 这一行。
一个常见误区:把项目放在 C:/Program Files 下面。这个目录默认需要管理员权限,PHP 写文件、写缓存都会失败,表现是「什么都没报错,但数据没存上」。

装完之后顺手做的事

打开 php.ini,把 display_errors 设为 On、error_reporting 设为 E_ALL,开发阶段让错误直接显示出来。上线后再关掉,改用日志。这两行能省掉大量「页面空白但不知道哪错了」的时间。

最后建议装一个编辑器插件,把 PHP 语法检查和格式化接上。代码风格统一,比任何教程都更能提升可读性。

文中提到的函数

接着读