XAMPP支持Perl开发：如何在本地环境配置并运行CGI脚本-php教程-PHP中文网

xampp 自带 perl 但默认不启用 cgi，需取消 httpd.conf 中 loadmodule cgid_module 注释、配置 scriptalias 与 directory 块启用 execcgi、确保 .pl 脚本 shebang 正确且输出合法 http 头（含 \r\n\r\n），错误时查 error_log 日志。

xampp支持perl开发：如何在本地环境配置并运行cgi脚本

XAMPP 自带 Perl，但默认不启用 CGI 执行能力；直接放 `.pl` 文件到 `cgi-bin` 目录下会 500 错误，核心问题不是“Perl 装没装”，而是 Apache 是否加载模块、是否授权执行、脚本是否合规。

确认 mod_cgi 或 mod_cgid 已启用

Apache 必须加载 CGI 支持模块，否则所有 `.pl` 或 `.cgi` 请求都会被拒绝。XAMPP 8.2+ 默认倾向用 mod_cgid（多进程），旧版可能用 mod_cgi，二者不能共存。

打开 C:\xampp\apache\conf\httpd.conf（Windows）或 /opt/lampp/etc/httpd.conf（Linux/macOS），搜索以下两行：

LoadModule cgid_module modules/mod_cgid.so —— 若存在且被注释（行首有 #），取消注释
LoadModule cgi_module modules/mod_cgi.so —— 若已启用，需先注释掉它，避免冲突

保存后重启 Apache。验证方式：访问 http://localhost/server-status（需已启用 mod_status），或查 error_log 中是否有 AH01506: failed to enable cgi 类错误。

配置 ScriptAlias 和 ExecCGI 权限

仅设置 ScriptAlias 不足以让脚本运行，<directory></directory> 块必须显式允许执行。

在 httpd.conf 或 etc/extra/httpd-cgi.conf 中确保包含：

<ifmodule alias_module>
    ScriptAlias /cgi-bin/ "/opt/lampp/cgi-bin/"
</ifmodule><directory>
    AllowOverride None
    Options +ExecCGI
    Require all granted
</directory>

Windows 用户注意路径写法："C:/xampp/cgi-bin/"（正斜杠或双反斜杠），不要用单反斜杠 "C:\xampp\cgi-bin\"，否则 Apache 解析失败。

Options +ExecCGI 是强制项，漏掉就报 Forbidden 或 500
XAMPP 7.x 及更早版本用 Order allow,deny + Allow from all，别混用新旧语法
若自定义 CGI 目录（如 /htdocs/mycgi/），必须为该路径单独写 <directory></directory> 块

脚本文件权限与输出格式必须严格合规

CGI 对第一行 shebang 和 HTTP 头格式极其敏感，错一个字符就 End of script output before headers。

Linux/macOS 下运行前必须加执行权限：

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

下载

chmod a+x /opt/lampp/cgi-bin/test.pl

Windows 下虽不依赖 chmod，但若通过 WSL 或 Linux 版 XAMPP 运行，仍需此步。

shebang 行必须指向真实 Perl 路径：#!/opt/lampp/perl/bin/perl（Linux）或 #!C:/xampp/perl/bin/perl.exe（Windows），不能写 #!/usr/bin/perl
HTTP 头必须以 \r\n\r\n 结尾（Windows 风格换行），不能是 \n\n；Perl 中用双引号字符串：print "Content-Type: text/html\r\n\r\n";
脚本开头不能有 UTF-8 BOM，编辑器保存时选 “UTF-8 无 BOM”
任何前置输出（如空行、use warnings 触发的 warning）都会破坏 header，导致 500

调试时优先看 error_log，而不是浏览器报错

浏览器只显示通用 500 错误，真正线索全在日志里。

查看 /opt/lampp/logs/error_log（Linux/macOS）或 C:\xampp\apache\logs\error.log（Windows），重点关注三类错误：

End of script output before headers → 脚本没输出合法 header，或提前 exit/ die
(13) Permission denied: exec of 'xxx' → shebang 路径错，或文件无执行权
Can't locate CGI.pm → 想用 CGI 模块但未安装（XAMPP 自带 Perl 通常不含完整 CPAN，需手动 cpan CGI）

每次改完配置或脚本，务必重启 Apache 并清空浏览器缓存——CGI 不缓存，但浏览器可能缓存 500 响应。

最易被忽略的是 shebang 路径和换行符组合：Windows 编辑器默认 CRLF，Linux 环境下 Perl 解释器却可能因路径末尾隐含回车而找不到可执行文件。直接用 od -c test.pl | head -n2 查看第一行真实字节，比肉眼检查更可靠。