PHP 安装：Windows/Linux/macOS 环境搭建

PHP 安装方式选择

PHP 可以通过多种方式安装。不同操作系统的安装方法不同，下面分别介绍。

一、Windows 安装

方式1：使用 XAMPP（推荐新手）

XAMPP 是最流行的 PHP 开发环境包，包含 Apache + MySQL + PHP + Perl，一键安装。

1. 前往 https://www.apachefriends.org 下载 XAMPP
2. 运行安装程序，一路 Next 即可
3. 安装完成后，启动 Apache 和 MySQL 服务
4. 浏览器访问 http://localhost 测试

方式2：手动安装

从 PHP 官网下载二进制包：

1. 访问 https://www.php.net/downloads.php
2. 下载 PHP Windows 版本（Thread Safe 版）
3. 解压到 C:\php
4. 配置环境变量：将 C:\php 加入 PATH
5. 验证：php -v

方式3：使用 PHPStudy（小皮面板）

1. 下载 PHPStudy：https://www.xp.cn
2. 安装后选择 PHP 版本和 MySQL 版本
3. 一键启动 Nginx/Apache + MySQL
4. 网站根目录：C:\phpstudy_pro\WWW

二、Linux 安装（Ubuntu/Debian）

方式1：apt 安装

sudo apt update
sudo apt install php php-mysql php-cli php-curl php-gd php-mbstring\n# 验证\nphp -v\n# 查看已安装模块\nphp -m

方式2：编译安装（指定版本）

# 安装依赖\nsudo apt install build-essential libxml2-dev libssl-dev\n\n# 下载 PHP 源码\nwget https://www.php.net/distributions/php-8.2.10.tar.gz\ntar -xzf php-8.2.10.tar.gz\ncd php-8.2.10\n\n# 编译配置\n./configure --with-apxs2=/usr/bin/apxs2 --with-mysql\n\n# 编译安装\nmake\nsudo make install\n\n# 验证\nphp -v

三、macOS 安装

方式1：Homebrew（推荐）

# 安装 Homebrew（如果没有）\n/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"\n\n# 安装 PHP\nbrew install php\n\n# 验证\nphp -v\n\n# 启动 PHP 内置服务器\nphp -S localhost:8000

方式2：macOS 自带 PHP

macOS 内置了 PHP，但版本较旧。启用方法：

# 查找 PHP 路径\nwhich php\n/usr/bin/php -v\n\n# 启动内置服务器\ncd ~/Sites/myproject\nphp -S localhost:8000

四、PHP.ini 基础配置

php.ini 是 PHP 的核心配置文件，决定了 PHP 的行为。

查找 php.ini 位置

php -i | grep "php.ini"\n# 或\nphp --ini

常用配置项

; 设置时区\ndate.timezone = Asia/Shanghai\n\n; 错误报告级别\nerror_reporting = E_ALL\ndisplay_errors = On\n\n; 文件上传限制\nupload_max_filesize = 10M\npost_max_size = 20M\n\n; 脚本内存限制\nmemory_limit = 128M\n\n; 最大执行时间\nmax_execution_time = 30\n\n; 禁止显示 PHP 版本信息\nexpose_php = Off

五、验证安装成功

创建测试文件

<?php\nphpinfo();\n?>

将以上内容保存为 info.php，放到网站根目录，浏览器访问：

http://localhost/info.php

如果看到 PHP 版本信息和配置表格，说明安装成功。

六、PHP 内置开发服务器

PHP 5.4+ 自带内置服务器，适合开发测试：

# 在项目目录启动\ncd /path/to/your/project\nphp -S localhost:8000\n\n# 指定根目录\nphp -S localhost:8000 -t /var/www/html\n\n# 带路由器（支持路由重写）\nphp -S localhost:8000 router.php

七、常见安装问题

1. 缺少 Visual C++ 运行库（Windows）

下载安装 Visual Studio 2015/2017/2019/2022 C++ 运行库。

2. 端口被占用

Apache/Nginx 启动失败，80/443 端口被占用：

# Windows 查找端口占用\nnetstat -ano | findstr :80\n\n# Linux 查找\nsudo lsof -i :80

3. 权限问题（Linux）

# 给项目目录权限\nsudo chown -R www-data:www-data /var/www/html\nsudo chmod -R 755 /var/www/html

总结

• Windows 新手：用 XAMPP 或 PHPStudy，一键安装
• Linux：apt install php 最简单
• macOS：Homebrew brew install php
• 安装后必做：phpinfo() 验证 + php.ini 基础配置
• 开发阶段用 php -S localhost:8000 内置服务器