如何在服务器上安装 PHP(Linux / Windows / macOS)

这篇文章会带你在 Linux、Windows 和 macOS 三个系统上完成 PHP 的安装,并介绍如何与 Apache 或 Nginx 配合使用、安装常用扩展,以及验证安装是否成功。

如何在服务器上安装 PHP(Linux / Windows / macOS)

安装前的准备工作

正式开始之前,有几件事需要先确认,跳过这些步骤很容易在后面遇到报错。

命令行基础(Linux / macOS 用户):安装过程中需要在终端里输入命令,熟悉基本的目录导航和包管理操作会让整个过程顺畅很多。

管理员权限:安装软件、修改配置文件都需要 root 或管理员权限,没有这个权限安装无法完成。

更新系统:安装前先把系统更新一遍,可以避免很多兼容性问题。Ubuntu/Debian 用 sudo apt update && sudo apt upgrade,CentOS 用 sudo yum update

检查是否已安装:有些系统自带 PHP,先在终端运行 php -v 确认一下。如果显示版本号,说明已经安装;如果报错,再继续下面的步骤。


在 Linux 上安装 PHP

Linux 是跑 PHP 最常见的环境,不同发行版的命令略有差异。

Ubuntu / Debian 系

第一步:更新软件包列表

sudo apt update

第二步:安装 PHP 及常用模块

这条命令会同时安装 PHP、Apache 集成模块和 MySQL 支持,大多数应用都需要这些。

sudo apt install php libapache2-mod-php php-mysql

第三步:验证安装

php -v

第四步:配置 Web 服务器

使用 Apache 的话,重启服务即可:

sudo systemctl restart apache2

使用 Nginx 的话,需要安装 PHP-FPM 来处理 PHP 文件:

sudo apt install php-fpm
sudo systemctl restart nginx

CentOS / RHEL 系

# 更新系统
sudo yum update

# 安装 PHP 及扩展
sudo yum install php php-cli php-mysqlnd

# 验证版本
php -v

# 重启 Web 服务器
sudo systemctl restart httpd   # Apache
sudo systemctl restart nginx   # Nginx

Fedora

# 安装 PHP
sudo dnf install php php-cli php-mysqlnd

# 验证版本
php -v

# 重启 Web 服务器
sudo systemctl restart httpd   # Apache
sudo systemctl restart nginx   # Nginx

到这里,PHP 在 Linux 上的安装就完成了,接下来可以进行配置和测试。


在 Windows Server 上安装 PHP

Windows 不自带 PHP,需要手动安装配置。

第一步:从官网下载 PHP

前往 php.net 下载适合 Windows 的最新稳定版。注意版本选择:配合 Apache 使用选 Thread Safe 版,配合 IIS 使用选 Non-Thread Safe 版。

第二步:解压文件

将下载的压缩包解压到一个固定目录,比如:

C:\php

第三步:配置 php.ini

在解压目录里找到 php.ini-developmentphp.ini-production,复制一份并重命名为 php.ini,用文本编辑器打开,按需开启所需扩展(如 extension=mysqli)和设置时区。

第四步:添加到系统环境变量

为了能在任意位置执行 PHP 命令,需要把 PHP 目录加入系统 PATH:

右键”此电脑”→ 属性 → 高级系统设置 → 环境变量 → 在系统变量中找到 Path → 编辑 → 新增 C:\php,保存后重启服务器。

第五步:与 Web 服务器集成

使用 Apache 的话,打开 httpd.conf 文件,在末尾添加:

LoadModule php_module "C:/php/php8apache2_4.dll"
AddHandler application/x-httpd-php .php
PHPIniDir "C:/php"

保存后重启 Apache。

使用 IIS 的话,可以安装 PHP Manager for IIS 工具,通过图形界面完成注册和配置,省去手动编辑的麻烦。

第六步:验证安装

在网站根目录(如 C:\inetpub\wwwroot\)创建一个 phpinfo.php 文件,内容如下:

<?php
phpinfo();
?>

打开浏览器访问 http://localhost/phpinfo.php,看到 PHP 配置信息页面就说明安装成功了。


在 macOS 上安装 PHP

先检查是否已预装

php -v

较旧版本的 macOS 会自带 PHP,较新版本已经移除了。如果命令报错,继续下面的步骤。

安装 Homebrew

macOS 上最方便的方式是通过 Homebrew 安装 PHP。如果还没装 Homebrew,运行:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装 PHP

brew install php

启动 PHP 服务

brew services start php

验证安装

php -v

看到版本号就大功告成了。


安装 PHP 扩展

PHP 扩展为服务器提供额外功能,很多应用都依赖特定扩展才能正常运行。比如 WordPress 需要 mysqlipdo_mysql 连接数据库,Laravel 依赖 mbstring,图片处理功能需要 gdimagick

Ubuntu / Debian

sudo apt install php-xml php-curl php-gd

安装后重启 Apache 或 Nginx。

CentOS / RHEL

sudo yum install php-xml php-curl php-gd

Windows

PHP 的 Windows 安装包里已经包含这些扩展文件,只是默认没有启用。打开 php.ini,找到对应扩展的那一行,去掉行首的分号即可启用:

;extension=curl   →   extension=curl
;extension=gd     →   extension=gd

保存文件,重启 Apache 或 IIS。


测试安装是否正常

创建测试文件

在 Linux 上,进入网站根目录创建文件:

nano /var/www/html/phpinfo.php

写入以下内容:

<?php
phpinfo();
?>

在浏览器中访问

http://你的服务器IP/phpinfo.php

如果能看到一个详细的 PHP 配置信息页面,说明安装和配置都没问题。如果页面直接下载而不是展示内容,说明 Web 服务器还没正确处理 PHP 文件,需要回头检查配置。

测试完记得删除这个文件,该页面会暴露服务器的详细配置信息,不适合公开访问。


常见问题处理

命令行不识别 php 命令:通常是 PHP 没有加入系统 PATH。Windows 用户检查环境变量配置,Linux / macOS 用户检查 shell 配置文件。

PHP 文件被下载而不是执行:说明 Web 服务器没有配置好 PHP 处理。Apache 用户检查 PHP 模块是否启用,Nginx 用户检查 PHP-FPM 配置,修改后重启服务器。

安装了旧版本的 PHP:有些系统默认安装较旧的版本。可以指定版本安装,比如 sudo apt install php8.1;Windows 用户直接从 php.net 下载所需版本。

报错提示缺少扩展:根据错误信息,用对应的包管理器安装缺失的扩展,或在 php.ini 里启用。


保持 PHP 更新

运行过时版本的 PHP 会带来安全风险,官方已停止支持的版本不再获得安全补丁。

Linux 更新命令:

# Ubuntu/Debian
sudo apt update && sudo apt upgrade

# CentOS/RHEL
sudo yum update

# Fedora
sudo dnf upgrade

Windows:从官网下载新版本,替换安装目录中的文件,根据需要更新 php.ini,重启 Web 服务器。

建议定期检查 PHP 官网的版本公告,及时跟进更新,既能享受性能提升,也能保持安全防护。

PHP 装好之后,你的服务器就具备了托管动态网站和 Web 应用的基础能力。下一步可以着手连接数据库,或者搭建 Laravel、WordPress 这类框架和平台,让服务器真正跑起来。

原创文章,作者:余初云,如若转载,请注明出处:https://blog.jidcy.com/jsjc/2507.html

Like (0)
Previous 2026年4月20日 上午10:19
Next 2026年4月20日 上午11:38

相关推荐