PHP: 开发环境搭建

写 PHP 只需要两样东西:一个能让 PHP 运行的服务器环境,和一个写代码的编辑器。这节课帮你把这两样都装好,然后写出人生第一行 PHP 代码。

1. 选择 PHP 开发环境

运行 PHP 需要一个 Web 服务器 + PHP 引擎 + 数据库。你可以分别安装 Apache/Nginx、PHP、MySQL,但更简单的方式是装一个集成开发包,开箱即用。

集成包 平台 说明
XAMPP Windows / Mac / Linux 最流行,Apache + MariaDB(MySQL) + PHP + Perl
Laragon Windows 轻量快速,自动虚拟主机,推荐 Windows 用户
MAMP Mac / Windows Mac 用户首选
Laravel Herd Mac / Windows Laravel 官方出品,但偏框架开发者

本教程以 XAMPP 为准(跨平台、功能全、配置简单)。如果你用 Windows,Laragon 也是极好的选择。


2. 安装 XAMPP

(1) 步骤 1:下载

打开 https://www.apachefriends.org/,点击你操作系统对应的 Download 按钮。

💡 提示: 下载时选择 PHP 8.2 或 8.3 的版本,本教程所有代码基于 PHP 8.2+。

(2) 步骤 2:安装

双击下载的安装包,一路 Next,注意几点:

(3) 步骤 3:启动

打开 XAMPP Control Panel,点击 ApacheMySQL 旁边的 Start 按钮:

TEXT 📖 仅展示
XAMPP Control Panel
┌──────────────────────────────────────────┐
│  Apache     [Start]  →  80, 443 端口     │
│  MySQL      [Start]  →  3306 端口        │
│  FileZilla  [Start]  (不需要)            │
│  Mercury    [Start]  (不需要)            │
│  Tomcat     [Start]  (不需要)            │
└──────────────────────────────────────────┘

当 Apache 和 MySQL 旁边出现绿色背景的 "Running" 字样,就说明启动成功。

(4) 步骤 4:验证

打开浏览器,访问 http://localhost/ ,如果看到 XAMPP 欢迎页面,就说明一切正常。

再访问 http://localhost/phpmyadmin/ ,如果看到 phpMyAdmin 界面,说明 MySQL 也在运行。

⚠️ 注意: 如果 localhost 打不开,最常见的原因是端口冲突(比如 Skype/迅雷占用了 80 端口)。可以在 XAMPP 控制面板中修改 Apache 端口→ Config → Apache (httpd.conf) → 搜索 "Listen 80" → 改为 "Listen 8080" → 重启 Apache。


3. 安装 VS Code

写 PHP 代码只需要文本编辑器。推荐 VS Code(免费、轻量、插件丰富)。

安装后,装两个推荐扩展:

扩展名 作用
PHP Intelephense 代码提示、自动补全、错误检查
PHP Server 一键启动 PHP 内置服务器(可选,XAMPP 不用这个)

点击 VS Code 左侧的 Extensions 图标(或 Ctrl+Shift+X),搜索扩展名,Install 即可。


4. 你的第一个 PHP 程序

(1) 找到 XAMPP 的网站根目录

XAMPP 的网站文件放在 htdocs 目录下:

系统 路径
Windows C:\xampp\htdocs\
Mac /Applications/XAMPP/htdocs/
Linux /opt/lampp/htdocs/

htdocs 里面新建一个文件夹叫 myphp

TEXT 📖 仅展示
htdocs/
└── myphp/
    └── index.php   ← 我们来创建这个文件

(2) 创建 index.php

用 VS Code 打开 htdocs\myphp\ 文件夹(File → Open Folder),然后新建文件 index.php,输入以下代码:

▶ 示例:Hello World

PHP
<?php
echo "Hello, PHP!";
echo "<br>";
echo "今天是 " . date("Y年m月d日");
echo "<br>";

// 显示 PHP 版本和配置信息
phpinfo();
?>
▶ 试一试

保存文件,然后在浏览器访问 http://localhost/myphp/ ,你应该能看到:

恭喜!你已经成功运行了第一个 PHP 程序。

💡 提示: echo 是 PHP 最常用的输出语句,它把内容输出到 HTML 页面中。date() 函数获取当前时间。. (点号)是 PHP 的字符串拼接运算符。这些后面课程会详细讲。


5. PHP 文件的规则

规则 说明
文件扩展名 必须是 .php(不是 .html
PHP 标签 PHP 代码写在 <?php?> 之间
文件位置 必须放在 Web 服务器的文档根目录下(如 htdocs)
访问方式 通过 http://localhost/... 访问,不能双击文件打开
纯 PHP 文件 如果文件只有 PHP 代码,可以省略结尾的 ?>

▶ 示例:纯 PHP 文件(推荐不加 ?>

PHP
<?php
$name = "小明";
$age = 18;
echo "我叫{$name},今年{$age}岁。";
▶ 试一试
💡 提示: 纯 PHP 文件不写结尾 ?> 是 PHP 社区的最佳实践。为什么?因为如果 ?> 后面有空白行或空格,这些空白会被意外输出,可能导致 HTTP header 发送失败。这只是细节,但养成好习惯很重要。


6. PHP 运行方式总结

TEXT 📖 仅展示
┌──────────┐     请求      ┌──────────┐   执行PHP   ┌──────────┐
│  浏览器   │ ──────────→ │  Apache   │ ────────→ │ PHP引擎   │
│          │ ←────────── │ (Web服务) │ ←─────── │           │
└──────────┘   HTML响应   └──────────┘  生成HTML  └──────────┘
     ↑                                                 ↓
     └───────────── http://localhost/ ─────────────────┘

PHP 必须通过 Web 服务器访问http://localhost/...),不能像 .html 文件那样双击打开。双击 .php 文件会看到原始代码,而不是执行结果。

❓ 常见问题

Q 为什么访问 localhost 时不是 PHP 执行结果而是下载了 .php 文件?
A Apache 的 PHP 模块没有正确加载。检查 XAMPP Control Panel 中 Apache 是否显示绿色 Running,然后确认 httpd.conf 中有 LoadModule php_module 这行配置。
Q XAMPP 装好后,80 端口被占用怎么办?
A 可以改端口。在 XAMPP 控制面板点 Apache 的 Config → httpd.conf → 搜索 "Listen 80" → 改为 "Listen 8080" → 保存后重启 Apache。之后访问地址变为 http://localhost:8080/。
Q Mac 自带了 PHP,还需要装 XAMPP 吗?
A Mac 确实自带了 PHP,但版本旧且不含 MySQL 和 phpMyAdmin。建议装 XAMPP 或 Laravel Herd,它们管理更方便。

📖 小节

📝 作业

  1. 安装 XAMPP 和 VS Code,启动 Apache,访问 http://localhost/ 看到 XAMPP 欢迎页后截图。
  2. htdocs/myphp/ 创建 about.php,用 echo 输出你的姓名、城市和当前时间。
  3. 访问 http://localhost/myphp/about.php,确认能看到结果后,把运行效果截图。
Web-Tutorial.com

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核,确保内容准确可靠。如发现任何问题,欢迎向我们反馈。

100%

🙏 帮我们做得更好

我们是刚上线的编程教程站,几个人的小团队,精力有限。页面虽经检查,难免还有疏漏——链接失效、排版错乱、内容有误、语言生硬……

如果您发现了,麻烦告诉我们,我们会在收到反馈后第一时间进行修复,再次感谢您的光临 🙏