适用于 CAMPP v0.3.14

CAMPP 用户手册

使用 CAMPP 在自己的电脑上运行 PHP 网站和数据库所需了解的一切。

安装 CAMPP

CAMPP 是一个本地 Web 开发环境：将 Caddy（Web 服务器）、PHP、MySQL 或 MariaDB、PostgreSQL、phpMyAdmin 和 Adminer 集成在一个应用中。它在你自己的用户目录中运行，因此无需管理员权限。

  • Windows：CAMPP-x64.exe（推荐）或 .msi。便携版 .zip 文件无需安装即可运行；其中 离线 版已包含所有运行时。
  • macOS：universal.dmg 同时支持 Apple Silicon 和 Intel。打开后将 CAMPP 拖入「应用程序」文件夹即可。
  • Linux：.deb（Ubuntu/Debian）、.rpm（Fedora/openSUSE）、.AppImage 或便携版 .tar.gz。
在 Windows 上，SmartScreen 可能会提示这是未知应用。点击 More info，然后点击 Run anyway。macOS 版本已经过 Apple 签名和公证。

首次运行

首次打开 CAMPP 时，一个简短的设置向导会下载你选择的运行时。

  1. 在欢迎界面点击 Get Started。
  2. 选择需要的组件，并为每个组件选择版本。Caddy 和 PHP 是必需的。
  3. 在同一界面中，为要安装的每个数据库（MySQL/MariaDB 和 PostgreSQL）设置 root 密码。请记住它：登录数据库时需要使用。
  4. 点击 Download & Install。CAMPP 会下载并完成全部配置。
  5. 完成后，点击 Continue to Dashboard。
在 Linux 上，如果向导列出了缺少的系统软件包，请使用包管理器安装它们，然后点击 Retry Check。

启动和停止服务

Services：每一行显示版本、端口和状态，并带有用于启动或停止的开关。

Services 页面列出所有已安装的服务。使用每行的开关启动或停止服务，点击圆形箭头重启服务，或使用顶部的 Start all / Stop all。

列表下方的卡片可打开你的 Website、phpMyAdmin、Adminer 或 Projects folder。前三项需要 Caddy 处于运行状态。

服务默认端口地址
Web 服务器（Caddy）8080http://localhost:8080
PHP-FPM9000内部使用，供 Caddy 调用
MySQL / MariaDB3307127.0.0.1:3307
PostgreSQL5433127.0.0.1:5433
CAMPP 使用这些非标准端口，以便与你可能已安装的 MySQL 或 PostgreSQL 共存。

你的项目

将每个网站放在 项目文件夹 中各自的子文件夹里。要打开项目文件夹，请点击 Services 页面上的 Projects folder 卡片。

projects/
├── my-site/
│   ├── index.php
│   └── style.css
└── shop/
    └── index.html
  • http://localhost:8080/my-site/ 会运行 my-site/index.php。
  • 包含 index.html 的文件夹会作为静态网站提供。
  • 页面不存在，或文件夹中既没有 index.php 也没有 index.html 时，会显示 404 Not Found。请直接链接到文件，例如 /my-site/report.php。
http://localhost:8080 会显示 CAMPP 欢迎页面，包含你的 PHP 版本和快捷链接。

数据库

设置项MySQL / MariaDBPostgreSQL
主机127.0.0.1127.0.0.1
端口33075433
用户rootroot
密码安装时设置的 root 密码安装时设置的 root 密码

在 PHP 中使用 PDO 连接：

<?php
$mysql = new PDO('mysql:host=127.0.0.1;port=3307;dbname=test;charset=utf8mb4', 'root', 'your-password');
$pgsql = new PDO('pgsql:host=127.0.0.1;port=5433;dbname=postgres', 'root', 'your-password');
连接 MySQL 时请使用 127.0.0.1 而不是 localhost。使用 localhost 时，PHP 会尝试通过本地套接字连接，而不是 TCP 端口。
phpMyAdmin（http://localhost:8080/phpmyadmin）：以 root 用户和你的数据库密码登录。
Adminer（http://localhost:8080/adminer）：选择 MySQL 或 PostgreSQL，然后输入数据库密码。

phpMyAdmin 和 Adminer 始终会要求输入密码。这样即使你在网络中共享网站，数据库也能保持安全。

组件

Components：安装、重新安装或移除 CAMPP 运行的软件。

Components 页面显示每个组件及其已安装的版本。Install 用于添加缺失的组件，Uninstall 用于移除组件，Reinstall 可让你选择其他版本。

Reinstall：选择一个版本，然后点击 Reinstall。
要获取 PHP 的最新安全修复，请打开 Components → PHP → Reinstall，并选择标记为 Latest 的版本。
在安装、重新安装或移除组件之前，请先停止所有服务。

设置

Settings：更改会在下次启动服务时生效。
  • Network：Local only（默认）表示只有本机可以打开你的网站。LAN 允许同一网络中的其他设备访问。
  • Ports：如果某个端口已被其他程序占用，可在此更改。
  • Database passwords：输入新的 root 密码，或留空以保留当前密码。当前密码永远不会显示。
  • Delete all projects and databases：清空项目文件夹并删除所有数据库。此操作不会自动备份，请先备份。
只有在所有服务都停止时才能更改设置。主题（System、Light、Dark）可随时通过侧边栏底部的图标切换。

备份与恢复

Backup：一个包含你的项目和全部数据库数据的 zip 文件。
  1. 在 Services 页面点击 Stop all。
  2. 打开 Backup 并点击 Back up now。生成的 zip 文件会出现在列表中。
  3. 要恢复到某个备份，请点击 Restore。CAMPP 会先保存当前状态（标记为 before restore），因此恢复操作可以撤销。
  4. 点击 Delete 删除不再需要的备份。
Open folder 会显示备份的存放位置。要迁移到另一台电脑，请将 zip 文件复制到那台电脑的备份文件夹中。
数据库数据只能在相同的操作系统（Windows、macOS 或 Linux）上恢复。要在不同系统之间迁移数据库，请使用 phpMyAdmin 或 Adminer 导出，然后在另一台电脑上导入。

与其他设备共享

默认情况下，CAMPP 只在 127.0.0.1 上响应，因此其他人无法访问你的网站或数据库。

  • LAN 模式（Settings → Network）允许同一网络中的手机和其他电脑打开你的网站，例如 http://192.168.1.20:8080。
  • ngrok（Windows）可为你的网站提供一个公网地址。在 Components 页面安装 ngrok，在 Settings 中粘贴来自 ngrok.com 的 authtoken，然后在 Services 页面启动 ngrok。
请仅在可信网络中使用 LAN 模式和 ngrok，并设置强数据库密码。开启 LAN 模式时，如果密码强度不足，Settings 会发出警告。

故障排除

Debug：版本、文件夹、端口检查以及完全重置。
  • 服务无法启动：打开 Debug → Port check。如果某个端口显示 In Use，说明它已被其他程序占用；请在 Settings 中更改端口。
  • 无法登录 phpMyAdmin 或 Adminer：使用 root 和数据库密码。可在 Settings → Database passwords 中设置新密码。
  • 需要帮助：点击 Copy diagnostics，并将结果粘贴到 GitHub issue 中。
  • 从头开始：Reset installation 会删除运行时、数据库和设置。你的项目文件夹和备份会被保留。

CAMPP 的文件存放位置

系统位置
WindowsCAMPP 的安装文件夹（默认为 %LOCALAPPDATA%\CAMPP），或便携版的解压位置
macOS~/Library/Application Support/campp
Linux~/.local/share/campp

其中包含：projects（你的网站）、mysql/data 和 pgsql/data（数据库）、backups、logs 以及 runtime（下载的程序）。Debug → Folders 会显示你电脑上的确切路径。

截图会跟随本网站的浅色或深色主题显示。

用户手册 | CAMPP