PHP安装 #

一、安装方式概述 #

PHP开发环境的搭建有多种方式:

方式 适用场景 难度
集成环境(XAMPP/MAMP) 初学者、快速搭建 简单
包管理器 开发者、灵活配置 中等
Docker 团队开发、环境一致性 中等
源码编译 高级用户、自定义需求 困难

二、Windows安装 #

2.1 使用XAMPP(推荐新手) #

XAMPP是一个跨平台的集成开发环境,包含Apache、MySQL、PHP。

下载安装:

  1. 访问 Apache Friends 下载XAMPP
  2. 运行安装程序,选择安装目录(如 C:\xampp
  3. 安装完成后启动XAMPP Control Panel
  4. 启动Apache服务

验证安装:

cmd
C:\xampp\php\php.exe -v

2.2 手动安装PHP #

下载PHP:

  1. 访问 PHP官方下载页
  2. 下载Non-Thread Safe版本(用于FastCGI)或Thread Safe版本(用于Apache模块)
  3. 解压到 C:\php

配置环境变量:

  1. 右键"此电脑" → 属性 → 高级系统设置
  2. 点击"环境变量"
  3. 在系统变量中找到"Path",添加 C:\php

配置php.ini:

cmd
copy C:\php\php.ini-development C:\php\php.ini

编辑 php.ini,启用常用扩展:

ini
extension=curl
extension=gd
extension=mysqli
extension=pdo_mysql
extension=openssl

验证安装:

cmd
php -v

2.3 使用Chocolatey #

powershell
choco install php

三、macOS安装 #

3.1 使用MAMP(推荐新手) #

MAMP是macOS上的集成开发环境。

下载安装:

  1. 访问 MAMP官网 下载MAMP
  2. 安装并启动MAMP
  3. 点击"Start Servers"

3.2 使用Homebrew(推荐开发者) #

bash
brew install php

验证安装:

bash
php -v

启动PHP内置服务器:

bash
php -S localhost:8000

3.3 安装特定版本 #

bash
brew install php@8.2
brew install php@8.1

切换版本:

bash
brew unlink php
brew link php@8.2

四、Linux安装 #

4.1 Ubuntu/Debian #

bash
sudo apt update
sudo apt install php php-cli php-common php-mysql php-curl php-gd php-mbstring php-xml php-zip

验证安装:

bash
php -v

4.2 CentOS/RHEL #

bash
sudo yum install epel-release
sudo yum install php php-cli php-mysqlnd php-curl php-gd php-mbstring php-xml php-zip

4.3 安装特定版本 #

Ubuntu添加PPA源:

bash
sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.2

五、安装Composer #

Composer是PHP的依赖管理工具,现代PHP开发必备。

5.1 Windows安装 #

下载 Composer-Setup.exe 并运行。

5.2 macOS/Linux安装 #

bash
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

或使用Homebrew:

bash
brew install composer

5.3 验证安装 #

bash
composer -V

六、开发工具推荐 #

6.1 IDE #

IDE 特点 适用人群
PhpStorm 专业PHP IDE,功能强大 专业开发者
VS Code 轻量级,插件丰富 所有开发者
Sublime Text 快速轻量 轻度使用者

6.2 VS Code扩展推荐 #

  • PHP Intelephense:PHP智能提示
  • PHP Debug:调试支持
  • PHP Formatter:代码格式化
  • Composer:Composer支持
  • PHP DocBlocker:文档注释

七、配置PHP内置服务器 #

PHP 5.4+内置了开发服务器,无需配置Apache/Nginx。

7.1 启动服务器 #

bash
php -S localhost:8000

7.2 指定文档根目录 #

bash
php -S localhost:8000 -t public

7.3 指定路由文件 #

bash
php -S localhost:8000 router.php

八、验证环境 #

创建测试文件 info.php

php
<?php
phpinfo();

在浏览器访问 http://localhost:8000/info.php,查看PHP配置信息。

九、常见问题 #

9.1 命令找不到 #

确保PHP已添加到系统PATH环境变量中。

9.2 扩展未加载 #

检查 php.ini 中是否启用了对应扩展:

ini
extension=mysqli

重启服务后生效。

9.3 时区警告 #

php.ini 中设置时区:

ini
date.timezone = Asia/Shanghai

或在代码中设置:

php
<?php
date_default_timezone_set('Asia/Shanghai');

十、总结 #

本章介绍了PHP开发环境的安装方法:

  • Windows推荐使用XAMPP或手动安装
  • macOS推荐使用Homebrew或MAMP
  • Linux使用包管理器安装
  • Composer是必备的依赖管理工具
  • VS Code + Intelephense是不错的开发组合

环境搭建完成后,让我们开始编写第一个PHP程序!

最后更新:2026-03-26