跳到主要内容

PHP 环境配置

本章将介绍如何在不同的操作系统上安装和配置 PHP 开发环境。

PHP 安装​

Windows 安装​

方法一：使用 XAMPP（推荐新手）​

XAMPP 是一个集成了 Apache、MySQL、PHP 的开发环境，适合初学者快速搭建开发环境。

  1. 访问 XAMPP 官网 下载安装包
  2. 运行安装程序，选择安装目录（默认 C:\xampp）
  3. 安装完成后，打开 XAMPP Control Panel
  4. 启动 Apache 服务
  5. 将 PHP 文件放入 C:\xampp\htdocs 目录
  6. 浏览器访问 http://localhost/ 测试

方法二：手动安装 PHP​

  1. 访问 PHP 官网 下载 PHP
  2. 选择 Non-Thread Safe 版本（用于 IIS）或 Thread Safe 版本（用于 Apache）
  3. 解压到指定目录，如 C:\php
  4. 将 PHP 目录添加到系统环境变量 PATH
  5. 复制 php.ini-development 为 php.ini
  6. 编辑 php.ini，启用需要的扩展
; 取消注释以启用扩展
extension=curl
extension=gd
extension=mysqli
extension=pdo_mysql

macOS 安装​

使用 Homebrew​

# 安装 Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 PHP
brew install php

# 验证安装
php -v

使用 MAMP​

MAMP 是 macOS 上流行的 PHP 开发环境：

  1. 访问 MAMP 官网 下载
  2. 安装并启动 MAMP
  3. 点击 "Start Servers" 启动服务
  4. 网站根目录默认为 /Applications/MAMP/htdocs

Linux 安装​

Ubuntu/Debian​

# 更新包列表
sudo apt update

# 安装 PHP 和常用扩展
sudo apt install php php-cli php-common php-mysql php-zip php-gd php-mbstring php-curl php-xml php-bcmath

# 验证安装
php -v

CentOS/RHEL​

# 安装 EPEL 仓库
sudo yum install epel-release

# 安装 Remi 仓库（提供最新 PHP 版本）
sudo yum install https://rpms.remirepo.net/enterprise/remi-release-8.rpm

# 启用 PHP 8.2 模块
sudo dnf module enable php:remi-8.2

# 安装 PHP 和扩展
sudo yum install php php-cli php-mysqlnd php-zip php-gd php-mbstring php-xml

# 验证安装
php -v

开发工具​

代码编辑器​

VS Code（推荐）​

  1. 下载安装 Visual Studio Code
  2. 安装 PHP 扩展：
    • PHP Intelephense（智能提示）
    • PHP Debug（调试支持）
    • PHP Server（内置服务器）

PhpStorm​

JetBrains 出品的专业 PHP IDE，功能强大但收费。

命令行工具​

PHP 内置了开发服务器，适合本地测试：

# 在项目目录启动内置服务器
php -S localhost:8000

# 指定文档根目录
php -S localhost:8000 -t public/

# 指定路由文件
php -S localhost:8000 router.php

Composer 安装​

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

Windows 安装​

  1. 下载 Composer-Setup.exe
  2. 运行安装程序，选择 PHP 可执行文件路径
  3. 安装完成后，命令行运行 composer 验证

macOS/Linux 安装​

# 下载安装脚本
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

# 验证安装程序
php -r "if (hash_file('sha384', 'composer-setup.php') === 'dac665fdc30fdd8ec78b38b9800061b4150413ff2e3b6f88543c636f7cd84f6db9189d43a81e5503cda447da73c7e5b6') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

# 运行安装程序
php composer-setup.php

# 删除安装脚本
php -r "unlink('composer-setup.php');"

# 移动到全局路径
sudo mv composer.phar /usr/local/bin/composer

# 验证安装
composer -V

验证安装​

创建一个 PHP 文件测试环境是否正常：

<?php
// info.php
phpinfo();

在浏览器中访问这个文件，应该能看到 PHP 配置信息页面。

命令行测试​

# 查看 PHP 版本
php -v

# 运行 PHP 代码
php -r "echo 'Hello, PHP!';"

# 交互式 Shell
php -a

常见问题​

1. 命令找不到​

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

2. 扩展未加载​

检查 php.ini 文件中是否启用了对应扩展，取消 extension= 前的分号。

3. 权限问题​

Linux/macOS 上可能需要设置文件权限：

# 设置目录权限
chmod -R 755 /var/www/html

# 设置所有者
chown -R www-data:www-data /var/www/html

4. 端口被占用​

如果 80 端口被占用，可以修改 Apache 配置或使用其他端口：

# 使用其他端口启动 PHP 内置服务器
php -S localhost:8080

小结​

本章我们学习了：

  1. 在 Windows、macOS、Linux 上安装 PHP
  2. 配置开发环境
  3. 安装 Composer 包管理器
  4. 验证 PHP 安装

下一章我们将开始学习 PHP 的基础语法。