PHP 环境搭建

"装环境"是新手最容易卡住的一步。本章给你三套方案,从最简单的 30 秒方案到最专业的全套方案,总有一款适合你。

1. 方案对比:选哪一种?

方案 A:PHP 内置服务器——最快,适合纯学语法。前提:本机已装 PHP 命令行。零配置,一条命令启动。
方案 B:XAMPP / Laragon——一站式,适合学习 Web 全流程(PHP + Apache + MySQL)。下载一个安装包就全有了。
方案 C:Docker——最贴近生产环境,适合团队协作和正式项目。配置略复杂,本文不展开,新手先用 A 或 B。

2. 方案 A:PHP 内置服务器(推荐新手起步)

从 PHP 5.4 起,PHP 自带了一个轻量级 Web 服务器,专门用于开发调试。你不需要装 Apache 或 Nginx,只要本机能跑 php 命令就行。

2.1 安装 PHP 命令行

macOS:系统自带 PHP(版本可能较旧)。推荐用 Homebrew 装最新版:brew install php。
Windows:到 windows.php.net 下载 ZIP 包,解压后把目录加入 PATH 环境变量。
Linux(Debian/Ubuntu):sudo apt install php-cli。

装完后在终端验证:

# 在命令行查看 PHP 版本(确认安装成功)
php -v
# 输出示例:
# PHP 8.3.0 (cli) (built: Nov 21 2024 09:23:30) (NTS)
# Copyright (c) The PHP Group
# Zend Engine v4.3.0, Copyright (c) Zend Technologies

2.2 启动内置服务器

新建一个项目目录,放一个 index.php 文件,然后启动服务器:

<?php
echo "Hello, PHP!";
echo "<br>";
echo "PHP 版本: " . PHP_VERSION;

# 进入你的项目目录
cd ~/projects/hello-php

# 启动 PHP 内置服务器(端口 8000)
php -S localhost:8000

# 然后浏览器打开 http://localhost:8000/
# 就能看到当前目录下的 index.php

浏览器访问 localhost:8000 即可看到输出。按 Ctrl+C 停止服务器。这个服务器只能本机访问,不能用于生产。

2.3 进阶:带路由脚本

如果想模拟"所有请求都入口到 index.php"的现代框架模式,可以用 -r 参数指定路由脚本:

# 指定一个路由脚本(常用于测试框架入口)
php -S localhost:8000 -t public public/index.php

# -t public  指定文档根目录为 public
# public/index.php  所有请求都交给这个脚本处理

3. 方案 B:XAMPP — 一站式集成包

XAMPP 是最经典的 PHP 开发环境整合包,跨平台,包含 Apache + MySQL + PHP + Perl,一键安装。

官网下载:apachefriends.org,选 PHP 8.x 版本。
安装后启动 XAMPP Control Panel,点 Start 启动 Apache 和 MySQL。
把 .php 文件放到 htdocs 目录,浏览器访问 localhost/文件名.php。

# XAMPP 默认安装路径
# Windows:  C:\xampp
# macOS:    /Applications/XAMPP
# Linux:    /opt/lampp

# 启动 XAMPP 控制面板,启动 Apache + MySQL

# 把 .php 文件放到 htdocs 目录
# Windows:  C:\xampp\htdocs\hello.php
# macOS:    /Applications/XAMPP/htdocs/hello.php

# 浏览器访问 http://localhost/hello.php

3.1 替代品:Laragon(Windows 推荐)

如果你用 Windows,Laragon 比 XAMPP 更现代化:更轻量、支持多版本 PHP/Node/Python 切换、自动配本地域名(如 myapp.test)。官网 laragon.org 下载。

3.2 替代品:MAMP(macOS 推荐)

macOS 用户也可以选 MAMP,图形界面友好,Apache + MySQL + PHP 一键启动。

4. 选择编辑器

PhpStorm(JetBrains):PHP 界最强 IDE,智能提示、重构、调试、数据库工具一体。付费但有 30 天试用,学生可申请免费。
VS Code(免费):配合 PHP Intelephense 扩展,体验接近 PhpStorm。轻量、跨平台、生态丰富,推荐学生起步。
Sublime Text / Nova:轻量编辑器,适合临时改文件。

新手用 VS Code + Intelephense 完全够用,等项目复杂了再升级到 PhpStorm。

5. 项目目录结构(初学版)

学到第 10 篇左右你就会发现,把所有 PHP 文件都堆在根目录很快就乱成一团。建议从一开始就用如下结构:

index.php — 首页入口
about.php / contact.php — 各页面
includes/ — 公共代码(头部、尾部、数据库连接)
config.php — 配置文件(数据库密码等)
assets/ — 静态资源(CSS、JS、图片)
uploads/ — 用户上传的文件

等进入第 13 篇面向对象和第 14 篇 PDO 数据库,这套结构会自然过渡到更工程化的形态。

6. 调试小贴士

报错看不到:在 PHP 文件最前面加 ini_set('display_errors', 1); error_reporting(E_ALL); 强制输出错误。
查看变量内容:用 var_dump($var) 或 print_r($var) 打印结构和值。
写日志:error_log("调试信息") 会写入 PHP 错误日志,适合生产环境排查。
高级调试:装 Xdebug 扩展,可在编辑器里打断点、单步执行(PhpStorm/VS Code 都支持)。

小结

这一章你装好了 PHP 环境,知道怎么用内置服务器或XAMPP跑起 .php 文件,选好了编辑器。下一篇我们正式进入 PHP 语言本身,看看它的基础语法长什么样。

← 上一篇 PHP 简介

下一篇 PHP 基础语法 →

✈️💬