PHP 安装:本地环境搭建完整指南
为什么需要安装 PHP
PHP 是一种服务器端脚本语言,需要在服务器上运行才能解析 .php 文件。在本地搭建 PHP 环境,是学习 PHP 开发的第一步。
一、Windows 安装 PHP
方式1:XAMPP(最简单,推荐新手)
XAMPP 是 Apache + MySQL + PHP + Perl 的集成包,一键安装,自动配置好所有依赖。
1. 访问 https://www.apachefriends.org 下载 XAMPP\n2. 运行安装程序,一路下一步即可\n3. 安装完成后,启动 Apache 和 MySQL 服务\n4. 打开浏览器访问 http://localhost\n5. XAMPP 网站根目录:C:\xampp\htdocs\
方式2:WAMP
1. 下载 WAMP:http://www.wampserver.com\n2. 安装时选择合适的 Apache、PHP、MySQL 版本\n3. 启动后托盘图标变绿色表示成功\n4. 访问 http://localhost 查看\n5. 网站根目录:C:\wamp64\www\
方式3:phpStudy(小皮面板)
1. 下载:https://www.xp.cn\n2. 选择 Nginx/Apache + MySQL 版本\n3. 一键启动,自动配置虚拟主机\n4. 网站根目录:C:\phpstudy_pro\WWW\
方式4:手动安装 PHP
1. 官网下载:https://www.php.net/downloads/\n2. 选择 Windows 版本(Thread Safe)\n3. 解压到 C:\php\n4. 配置环境变量:把 C:\php 加入 PATH\n5. 验证:php -v\n6. 配合 IIS 或 Nginx/Apache 使用
二、Linux 安装 PHP(Ubuntu/Debian)
apt 一键安装
sudo apt update\nsudo apt install php php-cli php-mysql php-curl php-gd php-mbstring php-xml php-zip\n\n# 验证版本\nphp -v\n\n# 查看已安装的 PHP 模块\nphp -m
指定版本安装(Ubuntu)
# 添加 PPA 获取更新的 PHP 版本\nsudo apt install software-properties-common\nsudo add-apt-repository ppa:ondrej/php\nsudo apt update\n\n# 安装 PHP 8.2\nsudo apt install php8.2 php8.2-cli php8.2-mysql php8.2-curl php8.2-gd
编译安装(指定版本)
# 安装编译依赖\nsudo apt install build-essential libxml2-dev libssl-dev libcurl4-openssl-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 安装 PHP
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 内置服务器\ncd ~/Sites/myproject\nphp -S localhost:8000
macOS 自带 PHP(版本较旧)
# 查看自带 PHP 版本\nphp -v\n\n# 启动内置服务器\ncd ~/Sites\nphp -S localhost:8000\n\n# 网站目录:~/Sites/
四、PHP.ini 基础配置
php.ini 是 PHP 的核心配置文件,决定了 PHP 的运行行为。
查找 php.ini 位置
php --ini\n# 或\nphp -i | grep "php.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; 脚本执行时间\nmax_execution_time = 30\n\n; 内存限制\nmemory_limit = 128M\n\n; 隐藏 PHP 版本信息\nexpose_php = Off
五、验证安装成功
创建测试文件 info.php:
<?php\nphpinfo();\n?>
放到网站根目录,浏览器访问 http://localhost/info.php。如果看到 PHP 版本信息和配置表格,说明安装成功。
六、PHP 内置开发服务器
PHP 5.4+ 自带内置服务器,不需要 Apache/Nginx 就能运行 PHP:
# 在项目目录启动\ncd /path/to/project\nphp -S localhost:8000\n\n# 指定网站根目录\nphp -S localhost:8000 -t /var/www/html\n\n# 带路由文件\nphp -S localhost:8000 router.php
七、常见问题
Visual C++ 运行库缺失(Windows)
下载安装 Visual Studio 2015/2017/2019/2022 C++ 运行库。
端口被占用
# Windows\nnetstat -ano | findstr :80\n\n# Linux\nsudo lsof -i :80
权限问题(Linux)
sudo chown -R www-data:www-data /var/www/html\nsudo chmod -R 755 /var/www/html
总结
- Windows 新手:用 XAMPP 或 phpStudy,一键安装
- Linux:apt install php 最简单
- macOS:brew install php
- 装完必做:phpinfo() 验证 + php.ini 基础配置
- 开发阶段用
php -S localhost:8000内置服务器即可