PHP 安装
下面给出在不同操作系统和环境下安装 PHP 的详细步骤与注意事项,帮助你快速、稳定地在本地或服务器上部署 PHP。
一、安装前准备
- 系统环境要求
- CPU:x86_64(大部分发行版都支持 ARM 架构,但常见主机以 x86_64 为主)
- 内存:≥512 MB(推荐 ≥1 GB)
- 网络:可访问官方或镜像源
- 软件依赖
- Web 服务器(可选):Apache、Nginx;
- 数据库(可选):MySQL/MariaDB、PostgreSQL、SQLite;
- 包管理工具(Linux):
apt
、yum
、dnf
; - 编译工具(源码安装):
gcc
、make
、autoconf
、libxml2-dev
等开发库;
- 安装方式概览
- 一键集成包:XAMPP、WampServer 等;
- 包管理器:系统自带软件源或第三方镜像源;
- 源码编译:获取 PHP 源码,自定义编译选项;
- 容器化:Docker 官方镜像。
二、Windows 下安装
1. 一键集成环境(推荐新手)
- XAMPP
- 官网下载 Windows 版本安装包;
- 运行安装向导,默认勾选 Apache、MySQL、PHP;
- 安装完成后启动 “XAMPP Control Panel”,启动 Apache 即可;
- PHP 的配置文件位于
C:\xampp\php\php.ini
,可根据需要调整。
- WampServer
- 官网下载对应系统(32/64 位)安装包;
- 安装过程中选择浏览器、编辑器等;
- 启动后系统托盘图标变为绿色表示正常;
- PHP.ini 在
C:\wamp\bin\php\php{版本}\php.ini
。
2. 手动安装(灵活定制)
- 从 php.net/releases 下载 Thread Safe 或 Non Thread Safe ZIP 包;
- 解压到
C:\php\php{版本}
,将目录添加到系统环境变量Path
; - 复制
php.ini-development
为php.ini
,根据需求启用/禁用扩展(extension=xxx); - 在 Apache 下启用:编辑
httpd.conf
,加入LoadModule php_module "C:/php/php{版本}/php7apache2_4.dll" AddHandler application/x-httpd-php .php PHPIniDir "C:/php/php{版本}"
- 重启 Apache,并在命令行中执行
php -v
验证。
三、macOS 下安装
1. Homebrew 安装(推荐)
brew update
brew install php # 默认安装最新稳定版
# 若要安装指定版本(例如 8.0):
brew install php@8.0
- 安装后,PHP 可执行文件在
/usr/local/bin/php
(Intel)或/opt/homebrew/bin/php
(Apple Silicon)。 - PHP 配置文件路径:
/usr/local/etc/php/{版本}/php.ini
。 - 启动 PHP-FPM:
brew services start php
;停止:brew services stop php
。
2. MacPorts(可选)
sudo port selfupdate
sudo port install php81 +apache2
- Apache 模块与 MacPorts 安装的 PHP 会自动集成。
四、Linux 下安装
提示:以下命令以 Debian/Ubuntu 与 CentOS/RHEL 为例。
1. Debian / Ubuntu
sudo apt update
# 安装最新默认版
sudo apt install php libapache2-mod-php php-cli php-mysql
# 常用扩展示例
sudo apt install php-xml php-mbstring php-zip php-gd php-curl
- Apache 集成:
libapache2-mod-php
,安装后会自动启用php.load
。 - PHP-FPM(与 Nginx 配合):
sudo apt install php-fpm sudo systemctl enable --now php*-fpm
2. CentOS / RHEL
sudo yum install epel-release yum-utils
# 启用 Remi 源(可选安装多个 PHP 版本)
sudo yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm
# 安装 PHP 8.1
sudo yum module reset php
sudo yum module enable php:remi-8.1
sudo yum install php php-cli php-fpm php-mysqlnd
# 常用扩展
sudo yum install php-xml php-mbstring php-zip php-gd php-opcache
- 启动/重启服务:
sudo systemctl enable --now php-fpm sudo systemctl restart httpd # Apache sudo systemctl restart nginx # Nginx
五、源码编译(高级定制)
- 获取源码
wget https://www.php.net/distributions/php-8.1.13.tar.gz tar xzf php-8.1.13.tar.gz cd php-8.1.13
- 准备编译依赖
# Debian/Ubuntu sudo apt install build-essential autoconf bison re2c libxml2-dev \ libsqlite3-dev libssl-dev libcurl4-openssl-dev libonig-dev
- 配置参数
./configure \ --prefix=/usr/local/php-8.1 \ --with-config-file-path=/usr/local/php-8.1/etc \ --enable-fpm \ --with-fpm-user=www-data --with-fpm-group=www-data \ --with-mysqli --with-pdo-mysql \ --enable-mbstring --enable-xml --enable-opcache
- 编译与安装
make -j$(nproc) sudo make install
- 配置
- 复制
php.ini-development
为php.ini
,并编辑; - 配置
php-fpm
服务脚本,或自行编写 systemd 单元文件; - 将
/usr/local/php-8.1/bin
添加到PATH
。
- 复制
六、容器化安装(Docker)
# Dockerfile 示例
FROM php:8.1-fpm
RUN docker-php-ext-install pdo_mysql mbstring zip gd opcache
# 若需 Apache:
# FROM php:8.1-apache
# RUN docker-php-ext-install mysqli pdo_mysql
- 构建镜像:
docker build -t my-php-app .
- 运行容器:
docker run -d -p 9000:9000 --name php-fpm my-php-app
- 与 Nginx 组合时,在 Nginx 配置中指向
fastcgi_pass php-fpm:9000;
。
七、安装后验证与配置
- 版本与模块检查
php -v # 查看版本 php -m # 列出已加载模块
- 创建测试页面
在 Web 根目录下info.php
:<?php phpinfo(); ?>
浏览器访问http://<你的域名或 IP>/info.php
,查看完整配置信息。 - 常用 php.ini 配置
date.timezone = "Asia/Shanghai" ; 设置时区 memory_limit = 256M ; 内存限制 upload_max_filesize = 50M ; 最大上传文件 post_max_size = 50M ; 最大 POST 大小 error_reporting = E_ALL display_errors = On ; 开发环境开启,生产环境建议 Off
- 重启服务
- Apache:
sudo systemctl restart apache2
或httpd
- Nginx + PHP-FPM:
sudo systemctl restart php*-fpm && sudo systemctl restart nginx
- Apache:
八、安装 Composer(可选)
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
composer --version
- 在项目目录运行
composer init
初始化,composer require vendor/package
安装依赖。
至此,你已完成 PHP 在主流环境下从安装、配置到验证的完整流程。可根据项目需求启用/卸载扩展、调整 php.ini
,并结合 Web 服务器进一步优化性能与安全。祝安装顺利!