PHP（Hypertext Preprocessor）是一种广泛应用的开源脚本语言，特别适用于 Web 开发，并可嵌入 HTML 中。为了开始使用 PHP，首先需要在本地或服务器上搭建一个 PHP 运行环境。本教程将详细介绍如何在不同操作系统下搭建 PHP 开发环境，包括 Windows、Linux 和 macOS。我们将涵盖手动搭建和使用集成环境两种方式，并提供完整的配置步骤和注意事项，帮助您顺利完成环境搭建。

PHP 环境搭建概述

在开始编写 PHP 程序之前，需要搭建一个能运行 PHP 脚本的环境。通常，这个环境包括：

  • Web 服务器：如 Apache、Nginx 等，用于处理 HTTP 请求。
  • PHP 解析器：解释和运行 PHP 脚本。
  • 数据库服务器：如 MySQL、MariaDB，用于存储和管理数据。

为了方便开发者，市面上有许多集成了以上组件的安装包，如 XAMPP、WAMP、MAMP 等，它们可以一次性安装所有必要的组件，节省配置时间。

在 Windows 上搭建 PHP 环境

使用集成环境 XAMPP

XAMPP 是一种易于安装的 Apache 发行版，包含 MariaDB、PHP 和 Perl，适用于 Windows、Linux 和 macOS。对于初学者和需要快速搭建环境的开发者来说，XAMPP 是一个理想的选择。

安装步骤

  1. 下载 XAMPP

    访问 XAMPP 官方网站，下载适用于 Windows 的最新版本。

  2. 运行安装程序

    双击下载的安装程序（如 xampp-windows-x64-8.0.0-0-VC15-installer.exe），可能会出现用户账户控制（UAC）提示，点击“是”继续。

  3. 选择组件

    在组件选择界面，可以选择需要安装的组件。默认情况下，Apache、MySQL、PHP 都会被选中。根据需求，可以添加或取消其他组件。

    组件 描述
    Apache Web 服务器
    MySQL 数据库服务器
    PHP PHP 解析器
    phpMyAdmin MySQL 管理工具
    FileZilla FTP FTP 服务器（可选）
    Tomcat Java 服务器（可选）

  4. 选择安装目录

    选择安装路径，建议安装在根目录下（如 C:\xampp），避免权限问题。

  5. 完成安装

    安装完成后，勾选“启动控制面板”选项，点击“完成”。

配置和测试

  1. 启动 Apache 和 MySQL

    在 XAMPP 控制面板中，点击“Start”按钮启动 Apache 和 MySQL 服务。

  2. 测试 Apache

    在浏览器中输入 http://localhost/，如果看到 XAMPP 欢迎页面，说明 Apache 运行正常。

  3. 测试 PHP

    创建一个测试文件：

    • 在 C:\xampp\htdocs\ 目录下，新建一个文件 test.php。

    • 在文件中输入以下内容：

      
    
      
     
      
      
       
        
      1
      
        
      2
      
        
      3
      		
       
        
      <?php
      
        
      phpinfo();
      
        
      ?>
      		
      
      
           
    
      • 
   
    • 
    
      在浏览器中访问 http://localhost/test.php，应显示 PHP 配置信息页面。
      • 
  
    4. 





常用配置


    
 
  • 
  
    更改 Apache 端口
    
  
    如果端口 80 被占用，可以修改 Apache 的监听端口。
    
  
      
   
    • 打开 C:\xampp\apache\conf\httpd.conf。
      • 
   
    • 将 Listen 80 改为 Listen 8080。
      • 
   
    • 将 ServerName localhost:80 改为 ServerName localhost:8080。
      • 
   
    • 重启 Apache 服务。
      • 
  
    • 
 
  • 
  
    配置虚拟主机
    
  
    在开发多个项目时，可以配置虚拟主机方便管理。
    
  
      
   
    • 
    
      编辑 C:\xampp\apache\conf\extra\httpd-vhosts.conf，添加：
      
    
      
    
      
     
      
      
       
        
      1
      
        
      2
      
        
      3
      
        
      4
      		
       
        
      <VirtualHost *:80>
      
        
          DocumentRoot "C:/xampp/htdocs/project1"
      
        
          ServerName project1.local
      
        
      </VirtualHost>
      		
      
      
           
    
      
    
      修改 C:\Windows\System32\drivers\etc\hosts，添加：
      
    
      
    
      
     
      
      
       
        
      1
      		
       
        
      127.0.0.1   project1.local
      		
      
      
           
    
      • 
  
    • 





手动安装 Apache、PHP 和 MySQL


对于需要更高控制度的开发者，可以手动安装和配置各个组件。




安装 Apache


    
 
  1. 
  
    下载 Apache
    
  
    访问 Apache Lounge，下载适用于 Windows 的二进制版本。
    2. 
 
  2. 
  
    解压安装
    
  
      
   
    • 将下载的 ZIP 文件解压到 C:\Apache24。
      • 
  
    3. 
 
  3. 
  
    配置环境变量
    
  
      
   
    • 将 C:\Apache24\bin 添加到系统环境变量 PATH 中。
      • 
  
    4. 
 
  4. 
  
    测试安装
    
  
      
   
    • 打开命令提示符，输入 httpd -v，应显示 Apache 版本信息。
      • 
  
    5. 
 
  5. 
  
    启动 Apache
    
  
      
   
    • 
    
      以管理员身份运行命令提示符，输入：
      
    
      httpd

      • 
  
    6. 





安装 PHP


    
 
  1. 
  
    下载 PHP
    
  
    访问 PHP 官方下载页面，选择适用于 Windows 的非线程安全（NTS）版本。
    2. 
 
  2. 
  
    解压安装
    
  
      
   
    • 将下载的 ZIP 文件解压到 C:\PHP。
      • 
  
    3. 
 
  3. 
  
    配置 PHP
    
  
      
   
    • 
    
      将 php.ini-development 重命名为 php.ini。
      • 
   
    • 
    
      编辑 php.ini，设置 extension_dir：
      
    
      
     
      
      
       
        
      1
      		
       
        
      extension_dir = "C:\PHP\ext"
      		
      
      
           
    
      • 
   
    • 
    
      启用必要的扩展，如 mysqli、pdo_mysql 等，去掉前面的分号：
      
    
      
     
      
      
       
        
      1
      
        
      2
      		
       
        
      extension=mysqli
      
        
      extension=pdo_mysql
      		
      
      
           
    
      • 
  
    4. 
 
  4. 
  
    配置 Apache 与 PHP 集成
    
  
      
   
    • 
    
      编辑 Apache 的配置文件 C:\Apache24\conf\httpd.conf，添加以下内容：
      
    
      
     
      
      
       
        
      1
      
        
      2
      
        
      3
      		
       
        
      LoadModule php_module "C:/PHP/php7apache2_4.dll"
      
        
      AddHandler application/x-httpd-php .php
      
        
      PHPIniDir "C:/PHP"
      		
      
      
           
    
      • 
   
    • 
    
      确保 DocumentRoot 指向您的项目目录。
      • 
  
    5. 
 
  5. 
  
    测试 PHP
    
  
      
   
    • 
    
      在 DocumentRoot 目录下创建 index.php，内容为：
      
    
      
     
      
      
       
        
      1
      
        
      2
      
        
      3
      		
       
        
      <?php
      
        
      echo "Hello, PHP!";
      
        
      ?>
      		
      
      
           
    
      
    
      重启 Apache 服务，访问 http://localhost/，应显示 "Hello, PHP!"。
      • 
  
    6. 





安装 MySQL


    
 
  1. 
  
    下载 MySQL
    
  
    访问 MySQL 官方下载页面，选择适用于 Windows 的 MSI 安装程序。
    2. 
 
  2. 
  
    安装 MySQL
    
  
      
   
    • 运行安装程序，选择“自定义”安装，按照提示完成安装。
      • 
   
    • 配置 root 用户密码，记住该密码用于后续连接。
      • 
  
    3. 
 
  3. 
  
    测试连接
    
  
      
   
    • 
    
      打开命令提示符，输入：
      
    
      mysql -u root -p

      • 
   
    • 
    
      输入密码后，应进入 MySQL 命令行界面。
      • 
  
    4. 





配置 PHP 连接 MySQL


    
 
  • 
  
    在 php.ini 中确保已启用 mysqli 和 pdo_mysql 扩展。
    • 
 
  • 
  
    重启 Apache 服务，测试 PHP 连接 MySQL：
    
  
    
   
    
    
     
      
    1
    
      
    2
    
      
    3
    
      
    4
    
      
    5
    
      
    6
    
      
    7
    		
     
      
    <?php
    
      
    $conn = new mysqli("localhost", "root", "yourpassword");
    
      
    if ($conn->connect_error) {
    
      
        die("连接失败: " . $conn->connect_error);
    
      
    }
    
      
    echo "连接成功";
    
      
    ?>
    		
    
    
       
  
    • 





 在 Linux 上搭建 PHP 环境


Linux 是服务器最常用的操作系统之一，以下以 Ubuntu 为例介绍如何搭建 PHP 环境。




使用 LAMP 方案


LAMP 代表 Linux、Apache、MySQL/MariaDB、PHP 的组合，是经典的 Web 开发环境。






安装 Apache



 
  

   
    
1

    
2

   
    
sudo apt update

    
sudo apt install apache2

  

 





安装 MySQL 或 MariaDB


安装 MySQL



 
  

   
    
1

   
    
sudo apt install mysql-server

  

 



安装 MariaDB



 
  

   
    
1

   
    
sudo apt install mariadb-server

  

 







安装 PHP



 
  

   
    
1

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

  

 







配置 Apache


    
 
  • 
  
    设置 Apache 优先解析 PHP 文件
    
  
    编辑 /etc/apache2/mods-enabled/dir.conf，将 index.php 放在第一位：
    
  
    
   
    
    
     
      
    1
    
      
    2
    
      
    3
    		
     
      
    <IfModule mod_dir.c>
    
      
        DirectoryIndex index.php index.html index.cgi index.pl index.xhtml index.htm
    
      
    </IfModule>
    		
    
    
       
  
    • 
 
  • 
  
    启用必要的模块
    
  
    
   
    
    
     
      
    1
    		
     
      
    sudo a2enmod php7.4  # 根据实际 PHP 版本
    		
    
    
       
  
    • 





重启 Apache



 
  

   
    
1

   
    
sudo systemctl restart apache2

  

 









测试 PHP


    
 
  • 
  
    创建测试文件 /var/www/html/info.php，内容为：
    
  
    
   
    
    
     
      
    1
    
      
    2
    
      
    3
    		
     
      
    <?php
    
      
    phpinfo();
    
      
    ?>
    		
    
    
       
  
    • 
 
  • 
  
    在浏览器中访问 http://your_server_ip/info.php，应显示 PHP 配置信息页面。
    • 





安装和配置 Nginx、PHP-FPM 和 MySQL


Nginx 是高性能的 Web 服务器，搭配 PHP-FPM 可以提高 PHP 应用的性能。




安装 Nginx



 
  

   
    
1

    
2

   
    
sudo apt update

    
sudo apt install nginx

  

 





安装 PHP-FPM



 
  

   
    
1

   
    
sudo apt install php-fpm php-mysql

    

    

    

    

    

    

  

 





   
 
  

        # php
      
        # 开发语言
      
  
 
 Logo 
亚马逊云科技技术品牌专区
 
 
 
  
更多推荐
  
cover
 
2026黑马技术：端侧AI轻量化部署实战！告别大模型算力内卷
 
 
avatar 亚马逊云科技技术品牌专区
 
cover
 
【硬核长文】从卡门涡街物理方程到边缘网关温压补偿算法：工业蒸汽测控实战，深度解密靠谱的涡街流量计厂家有哪些
 
 
avatar 亚马逊云科技技术品牌专区
 
 
基于SpringBoot的内容管理系统（CMS）
 
随着互联网内容生态的持续爆发式增长，传统静态网站已难以满足企业对内容发布、多端适配、权限协同与数据治理的复合需求。内容管理系统（CMS）作为支撑数字内容生产、组织、分发与运营的核心基础设施，正加速向轻量化、模块化、云原生方向演进。本文基于Spring Boot 3.2.x微服务架构，结合MyBatis-Plus、Thymeleaf、Redis缓存、JWT鉴权及Vue3前端技术栈，设计并实现了一套高
 
avatar 亚马逊云科技技术品牌专区