Skip to content

第 2 章:PHP 开发环境搭建(全程手把手)

2.1 环境选择:Windows / Mac / Linux

Windows

Windows 是最常用的开发环境,适合新手入门。推荐使用一键环境包,如 phpStudy、XAMPP 等。

Mac

Mac 系统自带 PHP,但版本可能较旧。推荐使用 MAMP 或通过 Homebrew 安装最新版本。

Linux

Linux 是生产环境的首选,推荐使用 LAMP(Linux + Apache + MySQL + PHP)或 LNMP(Linux + Nginx + MySQL + PHP)。

2.2 一键环境包推荐(phpStudy / XAMPP / WAMP)

phpStudy

  • 特点:中文界面,操作简单,适合新手
  • 下载地址phpStudy 官网
  • 支持系统:Windows
  • 包含组件:Apache、Nginx、MySQL、PHP 多版本

XAMPP

  • 特点:跨平台,功能全面
  • 下载地址XAMPP 官网
  • 支持系统:Windows、Mac、Linux
  • 包含组件:Apache、MySQL、PHP、Perl

WAMP

  • 特点:专为 Windows 设计
  • 下载地址WAMP 官网
  • 支持系统:Windows
  • 包含组件:Apache、MySQL、PHP

2.3 安装 + 启动 Apache + MySQL

phpStudy 安装步骤

  1. 下载 phpStudy 安装包
  2. 双击安装,选择安装路径
  3. 安装完成后,启动 phpStudy
  4. 点击「启动」按钮,启动 Apache 和 MySQL

XAMPP 安装步骤

  1. 下载 XAMPP 安装包
  2. 双击安装,选择安装路径
  3. 安装完成后,启动 XAMPP Control Panel
  4. 点击「Start」按钮,启动 Apache 和 MySQL

验证服务启动

  • Apache 启动成功:显示绿色状态
  • MySQL 启动成功:显示绿色状态

2.4 测试环境是否成功(输出 phpinfo)

创建测试文件

  1. 在网站根目录(如 wwwhtdocs)创建 info.php 文件
  2. 编辑文件内容:
php
<?php
phpinfo();
?>

访问测试页面

  1. 打开浏览器
  2. 访问 http://localhost/info.php
  3. 如果看到 PHP 信息页面,说明环境搭建成功

2.5 代码编辑器推荐(VS Code + 插件)

VS Code

  • 特点:轻量、免费、功能强大
  • 下载地址VS Code 官网
  • 推荐插件
    • PHP Intelephense:PHP 智能提示
    • PHP Debug:PHP 调试
    • HTML CSS Support:HTML/CSS 支持
    • Prettier:代码格式化

其他编辑器

  • Sublime Text:轻量、快速
  • PhpStorm:专业 PHP IDE,功能全面但收费

2.6 第一个 PHP 程序:echo 输出

创建 hello.php 文件

在网站根目录创建 hello.php 文件:

php
<?php
echo "Hello, PHP!";
echo "<br>";
echo "Welcome to PHP programming!";
?>

访问页面

  1. 打开浏览器
  2. 访问 http://localhost/hello.php
  3. 看到输出:
    Hello, PHP!
    Welcome to PHP programming!

2.7 常见环境问题排查(端口占用、启动失败、无法访问)

端口占用问题

  • 症状:Apache 或 MySQL 启动失败
  • 解决方法
    1. 检查是否有其他程序占用端口 80(Apache)或 3306(MySQL)
    2. 在 phpStudy 中修改端口号
    3. 关闭占用端口的程序

启动失败问题

  • 症状:服务无法启动
  • 解决方法
    1. 检查错误日志
    2. 确保安装路径无中文
    3. 以管理员身份运行环境包

无法访问问题

  • 症状:浏览器访问 localhost 显示 404 或无法连接
  • 解决方法
    1. 确保 Apache 已启动
    2. 检查网站根目录是否正确
    3. 检查防火墙设置

PHP 版本问题

  • 症状:代码无法运行或出现语法错误
  • 解决方法
    1. 在 phpStudy 中切换 PHP 版本
    2. 确保代码与 PHP 版本兼容

小结

通过本章的学习,你已经成功搭建了 PHP 开发环境,并运行了第一个 PHP 程序。环境搭建是学习 PHP 的第一步,确保环境正常运行后,我们可以开始学习 PHP 的核心语法。

© 2026 编程马·菜鸟教程 版权所有