教程概览

对于初学者,我强烈推荐使用集成环境包,因为它简单快捷,能让你快速开始开发,对于有经验的开发者或需要高度定制环境的用户,手动安装则提供了更大的灵活性。

php mysql环境配置教程
(图片来源网络,侵删)
  • 集成环境包 (推荐新手)

    • 优点:一键安装,配置简单,包含 Apache/Nginx、PHP、MySQL 等所有必需组件,版本兼容性好。
    • 缺点:灵活性较低,环境更新可能滞后。
    • 推荐工具XAMPP (跨平台,最流行), WampServer (仅限 Windows), MAMP (仅限 macOS)。
  • 手动安装 (推荐进阶)

    • 优点:完全控制每个组件的版本和配置,环境纯净,更接近生产服务器。
    • 缺点:步骤繁琐,需要手动解决各种依赖和配置问题。
    • 组件:分别安装 Apache/NginxPHPMySQL

使用 XAMPP 集成环境包 (Windows/macOS/Linux)

XAMPP 是最流行、最容易上手的集成环境解决方案。

步骤 1:下载 XAMPP

  1. 访问 XAMPP 官方网站:https://www.apachefriends.org/
  2. 根据你的操作系统(Windows, macOS, Linux)下载对应的版本。
    • 注意:对于 Windows,推荐下载 XAMPP for Windows,对于 macOS,下载 XAMPP for macOS
  3. 选择一个包含你所需 PHP 版本的包,最新版本通常包含较新的 PHP。

步骤 2:安装 XAMPP

  1. 找到你下载的安装包(xampp-windows-x64-8.2.0-0-VS16-installer.exe)。
  2. 双击运行安装程序。
  3. 按照安装向导的提示进行操作。大部分选项都可以使用默认设置
    • 在选择组件的界面,确保 Apache (Web 服务器)、MySQL (数据库服务器) 和 PHP 被勾选。
    • 你可以选择安装路径,但默认的 C:\xampp (Windows) 或 /Applications/XAMPP (macOS) 通常是最好的选择。
  4. 等待安装完成。

步骤 3:启动并测试服务

  1. 安装完成后,启动 XAMPP Control Panel。
  2. 你会看到 Apache 和 MySQL 的模块,点击每个模块右侧的 Start 按钮。
    • Apache:启动你的本地 Web 服务器。
    • MySQL:启动你的本地数据库服务器。
    • ProFTPD:一个 FTP 服务器,通常不需要启动。
  3. 看到 ApacheMySQL 模块的 Status 变为 Running,并且按钮变为 Stop,说明服务已成功启动。
  4. 打开你的浏览器,访问 http://localhosthttp://127.0.0.1
  5. 如果看到 XAMPP 的欢迎页面,恭喜你,Web 服务器已成功运行!

步骤 4:配置虚拟主机 (可选,但推荐)

直接使用 http://localhost 访问项目不够灵活,配置虚拟主机可以为每个项目设置一个独立的域名(如 http://myproject.local)。

php mysql环境配置教程
(图片来源网络,侵删)

以 Windows 为例:

  1. 编辑 hosts 文件

    • Win + R,输入 drivers/etc/hosts 并回车,用记事本打开该文件。
    • 在文件末尾添加一行:0.0.1 myproject.local,这样系统就会把 myproject.local 解析到你的本地电脑。
  2. 编辑 Apache 配置文件

    • 在 XAMPP 安装目录下,找到 apache/conf/extra/httpd-vhosts.conf 文件,用文本编辑器打开。
    • 在文件末尾,复制并修改下面的模板:
    <VirtualHost *:80>
        DocumentRoot "C:/xampp/htdocs/myproject"  # 你的项目根目录
        ServerName myproject.local                 # 你在 hosts 文件中设置的域名
        <Directory "C:/xampp/htdocs/myproject">
            Options Indexes FollowSymLinks
            AllowOverride All
            Require all granted
        </Directory>
    </VirtualHost>
    • DocumentRootServerName 修改为你自己的信息。
  3. 启用 mod_rewrite 模块

    php mysql环境配置教程
    (图片来源网络,侵删)
    • 很多 PHP 框架(如 Laravel)需要这个模块来实现 URL 重写。
    • 打开 apache/conf/httpd.conf 文件。
    • 找到 #LoadModule rewrite_module modules/mod_rewrite.so 这一行,删除前面的 号。
    • 保存 httpd.confhttpd-vhosts.conf 文件。
  4. 重启 Apache

    • 回到 XAMPP Control Panel,点击 Apache 的 Stop 按钮,等它完全停止后,再点击 Start
  5. 测试

    • 将你的项目文件放到你指定的目录(如 C:/xampp/htdocs/myproject)。
    • 在浏览器中访问 http://myproject.local,你应该能看到你的项目了。

步骤 5:使用 phpMyAdmin 管理数据库

phpMyAdmin 是一个用 PHP 编写的、通过 Web 界面管理 MySQL 的工具,XAMPP 已经自带了。

  1. 确保 MySQL 服务正在运行。
  2. 在浏览器中访问 http://localhost/phpmyadmin
  3. 默认情况下,root 用户没有密码,直接点击 “执行”“Go” 即可登录。
  4. 登录后,你可以在这里创建数据库、用户,以及执行所有数据库管理操作。

手动安装 (以 Windows 为例)

这种方法更复杂,但能让你更好地理解每个组件的作用。

组件准备

  1. PHP: 从 PHP 官网 下载最新的 Windows ZIP 包(Thread Safe 版本,搭配 Apache 使用)。
  2. Apache: 从 Apache Lounge 官网 下载最新的 Apache 版本(选择 httpd-...-win64-VCxx.zip)。
  3. MySQL: 从 MySQL 官网 下载 MySQL Installer for Windows。

安装步骤

  1. 安装 MySQL

    • 运行你下载的 MySQL Installer。
    • 选择 "Full"(完整安装)或 "Custom"(自定义安装),新手建议选择 "Full"。
    • 按照向导操作,在设置 root 密码的步骤,务必设置一个强密码并记住它
  2. 安装 Apache

    • 将下载的 Apache ZIP 包解压到一个固定路径,C:\Apache24路径中不要包含空格和中文
    • 打开命令提示符(CMD),以管理员身份运行。
    • 进入 Apache 的 bin 目录:cd C:\Apache24\bin
    • 执行安装命令:httpd -k install
    • 如果提示你输入服务器名称,可以输入 localhost
    • 启动 Apache 服务:httpd -k start
    • 在浏览器访问 http://localhost,如果看到 "It works!",说明 Apache 安装成功。
  3. 安装 PHP

    • 将下载的 PHP ZIP 包解压到一个固定路径,C:\php

    • C:\php 目录下的 php.ini-development 文件复制一份,重命名为 php.ini,这是 PHP 的主配置文件。

    • 配置 php.ini

      • 用记事本打开 C:\php\php.ini
      • 搜索并取消以下配置项的注释(删除前面的分号 ):
        • extension_dir = "ext" -> extension_dir = "C:\php\ext" (填写你的绝对路径)
        • 根据你的需要,启用常用扩展,
          • ;extension=mysqli -> extension=mysqli (用于连接 MySQL)
          • ;extension=curl -> extension=curl (用于 HTTP 请求)
          • ;extension=gd -> extension=gd (用于图像处理)
          • ;extension=mbstring -> extension=mbstring (用于多字节字符串处理)
    • 让 Apache 加载 PHP

      • 打开 Apache 的配置文件 C:\Apache24\conf\httpd.conf

      • 在文件末尾添加以下两行代码:

        # 加载 PHP 模块
        LoadModule php_module "C:/php/php8apache2_4.dll"  # 注意:文件名可能因 PHP 版本而异,请根据你的文件名修改
        # 将 .php 文件交给 PHP 模块处理
        AddHandler application/x-httpd-php .php
      • 确保 LoadModule 指令指向了正确的 PHP 模块 DLL 文件。

  4. 整合与测试

    • 重启 Apache 服务:在 CMD 中执行 httpd -k restart
    • 在 Apache 的网站根目录(默认是 C:\Apache24\htdocs)下创建一个名为 info.php 的文件,内容如下:
      <?php
      phpinfo();
      ?>
    • 在浏览器中访问 http://localhost/info.php
    • 如果看到一个详细的 PHP 配置信息页面,说明 PHP 和 Apache 已经成功整合!检查页面中是否有 MySQL 相关的信息,以确认 mysqli 扩展已成功加载。

手动安装 phpMyAdmin

  1. phpMyAdmin 官网 下载最新版本。
  2. 将下载的 ZIP 包解压到 Apache 的网站根目录 C:\Apache24\htdocs 下,并重命名文件夹为 phpmyadmin
  3. 进入 phpmyadmin 目录,找到 config.sample.inc.php 文件,复制一份并重命名为 config.inc.php
  4. 打开 config.inc.php,找到 $cfg['blowfish_secret'] = ''; 这一行,在引号内填入一个任意的随机字符串,
    $cfg['blowfish_secret'] = 'b1s2c3r4e5t6'; // 任意字符串
  5. 保存文件,现在你就可以通过 http://localhost/phpmyadmin 访问 phpMyAdmin 了,使用你之前设置的 MySQL root 用户名和密码登录。

总结与常见问题

方法 优点 缺点 适合人群
集成环境 快速、简单、一键启动、组件齐全 不够灵活、环境固定 初学者、快速开发测试
手动安装 灵活可控、环境纯净、贴近生产 复杂、耗时、易出错 有经验的开发者、需要定制环境的用户

常见问题 (FAQ)

  • Q: 端口 80 被占用怎么办?

    • 原因:可能是 Skype、IIS、其他 Web 服务器等程序占用了 80 端口。
    • 解决:关闭占用端口的程序,或在 Apache/MySQL 配置中修改端口号(如 Apache 改为 8080)。
  • Q: 如何修改网站根目录?

    • XAMPP: 修改 apache/conf/httpd.conf 文件中的 DocumentRoot "C:/xampp/htdocs"<Directory "C:/xampp/htdocs"> 指令。
    • 手动安装: 修改 Apache24/conf/httpd.conf 文件中的 DocumentRoot 指令。
  • Q: 如何从命令行启动/停止服务?

    • XAMPP: 使用 XAMPP Control Panel。
    • 手动安装: 打开 CMD (管理员),进入对应组件的 bin 目录,使用 httpd -k start/stop/restartnet start/stop mysql 命令。
  • Q: 在代码中如何连接 MySQL?

    • 使用 mysqliPDO 扩展,一个简单的 mysqli 连接示例:

      <?php
      $servername = "localhost";
      $username = "root";
      $password = "你的密码"; // 如果是 XAMPP,默认为空;手动安装为你设置的 root 密码
      $dbname = "test_db";
      // 创建连接
      $conn = new mysqli($servername, $username, $password, $dbname);
      // 检查连接
      if ($conn->connect_error) {
          die("连接失败: " . $conn->connect_error);
      }
      echo "连接成功";
      $conn->close();
      ?>

希望这份详细的教程能帮助你成功搭建 PHP + MySQL 开发环境!祝你编码愉快!