CGI demo

淡淡的烟草味﹌ 2022-11-07 04:07 196阅读 0赞

配置nginx，发现 fastcgi\_pass 指令，好奇 CGI是怎么回事，搜索资料，并体验一下。做些记录，加深印象。

CGI 产生于 1990 年代，是最早的赋予网页交互能力的技术。主要用于处理表单数据。如今已经过时，但有些地方仍在使用。

使用的操作系统是 Fedora 33, 安装的 HTTPD 版本是 2.4.46.

# 1. 安装 HTTPD
    dnf install http
    # 2. 启动服务
    systemctl start httpd
    # 3. 创建cgi脚本 word.sh, 放在目录 /var/www/cgi-bin/ 并赋予执行权限
    # 一定要让 apache 用户具有执行此脚本的权限
    chmod a+x /var/www/cgi-bin/word.sh
    # 4. curl 访问测试
    curl -v localhost/cgi-bin/word.sh

访问测试会得到如下输出

[root@fedora cgi-bin]# curl http://localhost/cgi-bin/hello.sh
    Generated At 2021-03-10 20:23:41
    SERVER_NAME=localhost
    UNIQUE_ID=YEi6TdMO4WH4S3VhRO@YMQAAAIE
    SCRIPT_NAME=/cgi-bin/hello.sh
    GATEWAY_INTERFACE=CGI/1.1
    SERVER_SOFTWARE=Apache/2.4.46 (Fedora)
    DOCUMENT_ROOT=/var/www/html
    PWD=/var/www/cgi-bin
    REQUEST_URI=/cgi-bin/hello.sh
    SERVER_SIGNATURE=
    REQUEST_SCHEME=http
    QUERY_STRING=
    CONTEXT_DOCUMENT_ROOT=/var/www/cgi-bin/
    HTTP_ACCEPT=*/*
    REMOTE_PORT=43130
    SERVER_ADMIN=root@localhost
    HTTP_HOST=localhost:8081
    SERVER_ADDR=::1
    HTTP_USER_AGENT=curl/7.71.1
    CONTEXT_PREFIX=/cgi-bin/
    SHLVL=1
    SERVER_PROTOCOL=HTTP/1.1
    SERVER_PORT=8081
    SCRIPT_FILENAME=/var/www/cgi-bin/hello.sh
    REMOTE_ADDR=::1
    PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin
    REQUEST_METHOD=GET
    _=/usr/bin/printenv

浏览器直接访问 http://localhost/cgi-bin/hello.sh 更适合阅读。

## httpd ##

1.  Fedora 33 安装后, 默认主配置文件在 /etc/httpd/conf/httpd.conf  
    实际配置文件的路径可以通过多种方式确定,比如

*  man httpd.conf 查看man手册页
 *  httpd -V 查看 httpd 的版本以及编译信息, 其中就包含配置文件路径
 *  find /etc/ -name ‘*http*’ 绝大部分软件都把配置文件放在etc下,用find命令可以搜索

1.  根据默认配置文案, 确认如下信息:

*  httpd 启动后以 apache 的用户身份运行, 默认监听 80 端口
 *  httpd 的cgi脚本存放路径是 /var/www/cgi-bin
 *  可以 http:/localhost/cgi-bin/ 访问cgi脚本
 *  httpd 的日志在 /var/log/httpd/ 下, 有 access\_log error\_log 两个日志文件.

所以我把cgi脚本放在 /var/www/cgi-bin 路径下,并保证用户 apache 具备执行权限,  
最后通过访问 http:/localhost/cgi-bin/hello.sh 测试cgi脚本.

## cgi脚本 ##

#!/bin/bash
    echo  "Content-Type: text/plain";
    echo
    
    
    echo Generated At $(date "+%F %T")
    printenv

前两行的echo语句输出http响应头, 是必须的.  
printenv 会打印shell脚本执行环境中的所有环境变量.

## 排错 ##

一开始遇到了 HTTP/1.1 500 Internal Server Error,  
查看日志 /var/log/httpd/error\_log

tail -f /var/log/httpd/error_log

默认两行如下, 所以是执行权限问题.

Wed Mar 10 20:32:49.544896 2021] [cgid:error] [pid 39753:tid 39850] [client ::1:43138] AH01241: error spawning CGI child: exec of '/var/www/cgi-bin/h2.sh' failed (Permission denied): /var/www/cgi-bin/h2.sh
    [Wed Mar 10 20:32:49.545463 2021] [cgid:error] [pid 39753:tid 39850] [client ::1:43138] End of script output before headers: h2.sh

## 附：根据httpd配置文件确定 cgi 脚本目录 ##

我用vim打开 /etc/httpd/conf/httpd.conf，搜索 cig-bin

<IfModule alias_module>
        ScriptAlias /cgi-bin/ "/var/www/cgi-bin/"
    </IfModule>
    
    <Directory "/var/www/cgi-bin">
        AllowOverride None
        Options None
        Require all granted
    </Directory>