PHP 安装

下面给出在不同操作系统和环境下安装 PHP 的详细步骤与注意事项,帮助你快速、稳定地在本地或服务器上部署 PHP。


一、安装前准备

  1. 系统环境要求
    • CPU:x86_64(大部分发行版都支持 ARM 架构,但常见主机以 x86_64 为主)
    • 内存:≥512 MB(推荐 ≥1 GB)
    • 网络:可访问官方或镜像源
  2. 软件依赖
    • Web 服务器(可选):Apache、Nginx;
    • 数据库(可选):MySQL/MariaDB、PostgreSQL、SQLite;
    • 包管理工具(Linux):aptyumdnf
    • 编译工具(源码安装):gccmakeautoconflibxml2-dev 等开发库;
  3. 安装方式概览
    • 一键集成包:XAMPP、WampServer 等;
    • 包管理器:系统自带软件源或第三方镜像源;
    • 源码编译:获取 PHP 源码,自定义编译选项;
    • 容器化:Docker 官方镜像。

二、Windows 下安装

1. 一键集成环境(推荐新手)

  • XAMPP
    1. 官网下载 Windows 版本安装包;
    2. 运行安装向导,默认勾选 Apache、MySQL、PHP;
    3. 安装完成后启动 “XAMPP Control Panel”,启动 Apache 即可;
    4. PHP 的配置文件位于 C:\xampp\php\php.ini,可根据需要调整。
  • WampServer
    1. 官网下载对应系统(32/64 位)安装包;
    2. 安装过程中选择浏览器、编辑器等;
    3. 启动后系统托盘图标变为绿色表示正常;
    4. PHP.ini 在 C:\wamp\bin\php\php{版本}\php.ini

2. 手动安装(灵活定制)

  1. 从 php.net/releases 下载 Thread Safe 或 Non Thread Safe ZIP 包;
  2. 解压到 C:\php\php{版本},将目录添加到系统环境变量 Path
  3. 复制 php.ini-development 为 php.ini,根据需求启用/禁用扩展(extension=xxx);
  4. 在 Apache 下启用:编辑 httpd.conf,加入LoadModule php_module "C:/php/php{版本}/php7apache2_4.dll" AddHandler application/x-httpd-php .php PHPIniDir "C:/php/php{版本}"
  5. 重启 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

五、源码编译(高级定制)

  1. 获取源码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
  2. 准备编译依赖# Debian/Ubuntu sudo apt install build-essential autoconf bison re2c libxml2-dev \ libsqlite3-dev libssl-dev libcurl4-openssl-dev libonig-dev
  3. 配置参数./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
  4. 编译与安装make -j$(nproc) sudo make install
  5. 配置
    • 复制 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;

七、安装后验证与配置

  1. 版本与模块检查php -v # 查看版本 php -m # 列出已加载模块
  2. 创建测试页面
    在 Web 根目录下 info.php<?php phpinfo(); ?> 浏览器访问 http://<你的域名或 IP>/info.php,查看完整配置信息。
  3. 常用 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
  4. 重启服务
    • Apache:sudo systemctl restart apache2 或 httpd
    • Nginx + PHP-FPM:sudo systemctl restart php*-fpm && sudo systemctl restart nginx

八、安装 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 服务器进一步优化性能与安全。祝安装顺利!

类似文章

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注