XAMPP环境部署DolphinCMS XAMPP环境优化建议-php教程-PHP中文网

xampp 不适合部署 dolphincms，因其仅为 php 开发测试环境，缺乏生产级所需的权限隔离、进程管理、日志分级和安全加固能力。

xampp环境部署dolphincms xampp环境优化建议

直接说结论：XAMPP 不适合部署 DolphinCMS（注意不是 DolphinScheduler），它本质是面向 PHP 开发测试的轻量集成包，缺乏生产级 CMS 所需的权限隔离、进程管理、日志分级和安全加固能力。强行用 XAMPP 跑 DolphinCMS，90% 的问题都出在 Apache 权限、MySQL 字符集、PHP 扩展缺失和伪静态失效这四点上。

Apache 启动后无法访问 DolphinCMS 首页

常见现象是浏览器显示 403 Forbidden 或白屏，但 /opt/lampp/xampp start 显示 Apache running。根本原因不是端口冲突，而是 XAMPP 默认的 <directory></directory> 权限太严，且未启用 mod_rewrite。

先确认模块已启用：sudo /opt/lampp/bin/httpd -M | grep rewrite，若无输出，需编辑 /opt/lampp/etc/httpd.conf，取消 #LoadModule rewrite_module modules/mod_rewrite.so 前的注释
再改目录权限：找到 <directory></directory> 块，把里面的 Require all denied 改为 Require all granted，并确保 AllowOverride All 已开启
重启 Apache：/opt/lampp/xampp restart，不要只 start —— restart 才会重载配置

MySQL 连接失败或中文乱码

DolphinCMS 对字符集敏感，XAMPP 自带的 MySQL 默认用 latin1，而 DolphinCMS 安装脚本强制要求 utf8mb4。不改会导致安装卡在数据库初始化，或后台文章标题显示为问号。

XAMPP 8.0.30

XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin

下载

修改 /opt/lampp/etc/my.cnf，在 [mysqld] 下添加三行：character-set-server = utf8mb4、collation-server = utf8mb4_unicode_ci、skip-character-set-client-handshake
在 [client] 和 [mysql] 段下各加一行：default-character-set = utf8mb4
重启 MySQL：/opt/lampp/xampp restart，然后进命令行执行：mysql -u root -e "SHOW VARIABLES LIKE 'character%';"，确认所有值都是 utf8mb4

PHP 扩展缺失导致安装向导报错

DolphinCMS 安装页面提示 “cURL extension is not loaded” 或 “GD extension missing”，是因为 XAMPP 的 php.ini 里这些扩展默认是注释掉的，且没开 opcache，影响后台加载速度。

编辑 /opt/lampp/etc/php.ini，搜索 ;extension=curl 和 ;extension=gd，去掉分号；再搜 ;opcache.enable=0，改为 opcache.enable=1
注意路径：XAMPP 的 PHP 扩展库在 /opt/lampp/lib/php/extensions/no-debug-non-zts-20220829/（PHP 8.2 版本号可能不同，用 php -i | grep extension_dir 确认）
改完执行：/opt/lampp/xampp restart，再用 php -m | grep -E "curl|gd|opcache" 验证是否加载成功

伪静态（Rewrite）规则不生效

DolphinCMS 后台生成的 URL 是 /index.php?m=content&c=index&a=lists&catid=1 这种形式，但实际需要 /content/lists/1.html。XAMPP 默认不读取站点根目录下的 .htaccess，即使你写了规则也无效。

必须在 Apache 主配置中显式允许 .htaccess 覆盖：确保 <directory></directory> 块里有 AllowOverride All（前面已提过，但这是最常漏改的一处）
DolphinCMS 的 .htaccess 文件需放在其安装目录根下（如 /opt/lampp/htdocs/dolphincms/.htaccess），不能放在子目录里
如果仍不生效，临时在 .htaccess 顶部加一行：RewriteEngine On，并检查 Apache 错误日志：tail -f /opt/lampp/logs/error_log，看是否有 Invalid command 'RewriteEngine' 类报错（说明 mod_rewrite 没启）

真正麻烦的不是配置本身，而是 XAMPP 的日志分散在多个地方：/opt/lampp/logs/error_log（Apache）、/opt/lampp/logs/php_error_log（PHP）、/opt/lampp/logs/mysql_error_log（MySQL）。出问题时别只盯一个，三个一起 tail 才能快速定位真实源头。