标签：rpm安装 ini min link expr 字符 spec rri 相对路径
[root@localhost ~]# httpd -h Usage: httpd [-D name] [-d directory] [-f file] [-C "directive"] [-c "directive"] [-k start|restart|graceful|graceful-stop|stop] [-v] [-V] [-h] [-l] [-L] [-t] [-T] [-S] [-X] Options: -D name : define a name for use in <IfDefine name> directives -d directory : specify an alternate initial ServerRoot -f file : specify an alternate ServerConfigFile -C "directive" : process directive before reading config files -c "directive" : process directive after reading config files -e level : show startup errors of level (see LogLevel) -E file : log startup errors to file -v : show version number -V : show compile settings -h : list available command line options (this page) -l : list compiled in modules -L : list available configuration directives -t -D DUMP_VHOSTS : show parsed vhost settings -t -D DUMP_RUN_CFG : show parsed run settings -S : a synonym for -t -D DUMP_VHOSTS -D DUMP_RUN_CFG -t -D DUMP_MODULES : show all loaded modules -M : a synonym for -t -D DUMP_MODULES -t : run syntax check for config files -T : start without DocumentRoot(s) check -X : debug mode (only one worker, do not detach)
apachectl命令和httpd命令基本相同。httpd接受的选项，apachectl都接受。但apachectl还可以省略"-k"选项直接管理httpd进程。
apachectl [-k] start：按照默认路径，读取默认配置文件，并启动httpd。 apachectl [-k] stop：关闭httpd进程。 apachectl [-k] restart：重启httpd进程。 apachectl [-k] graceful-stop：graceful stop，表示让已运行的httpd进程不再接受新请求，并给他们足够的时间处理当前正在处理的事情，处理完成后才退出。所以在进程退出前，日志文件暂时不会关闭，正在进行的连接暂时不会断开。 apachectl [-k] graceful：graceful restart，即graceful-stop+start。 apachectl [-k] configtest：语法检查。 在systemd环境下，还可以使用apachectl status或systemctl status httpd查看httpd进程的详细信息。
httpd的核心体现在配置文件，各种功能都通过配置文件来实现。使用rpm包安装的httpd默认配置文件为/etc/httpd/conf/httpd.conf。可以使用httpd -f config_path指定要加载的配置文件。
配置文件中全是一些指令配置，每个指令都是某个模块提供的。以下是配置文件的一些规则：
Include conf.d/*.conf指令建议不要移动位置。设置监听套接字。设置方式很简单，包括以下几种情况：
# 监听两个端口 Listen 80 Listen 8000 # 监听套接字绑定在给定地址和端口上 Listen 192.170.2.1:80 Listen 192.170.2.5:8000
该指令设置httpd的安装位置，也就是常称之为的basedir，在此目录下应该具有module、logs等目录。rpm安装的httpd的ServerRoot默认为/etc/httpd，编译安装的ServerRoot路径由"--prefix"选项指定，例如/usr/local/apache。
[root@localhost ~]# ls /etc/httpd/ -l 总用量 0 drwxr-xr-x. 2 root root 37 12月 16 14:08 conf drwxr-xr-x. 2 root root 82 12月 16 14:08 conf.d drwxr-xr-x. 2 root root 146 12月 16 14:08 conf.modules.d lrwxrwxrwx. 1 root root 19 12月 16 14:08 logs -> ../../var/log/httpd lrwxrwxrwx. 1 root root 29 12月 16 14:08 modules -> ../../usr/lib64/httpd/modules lrwxrwxrwx. 1 root root 10 12月 16 14:08 run -> /run/httpd
这个指令很关键，安装好apache后一般不会去做任何修改，因为很多指令的路径以及相对路径都是基于此路径的。严格地说，除了网络路径，基本上所有本地文件系统类的路径只要不是绝对路径，相对路径都基于此路径展开。
例如，当指定"ServerRoot /usr/local/apache"时，下面几个指令中描述的本地路径，等号前面的采用的都是相对路径，等号右边的都是他们等价的绝对路径写法。
DocumentRoot "htdocs" = DocumentRoot "/usr/local/apache/htdocs" LoadModule dir_module modules/mod_dir.so = LoadModule dir_module /usr/local/apache/modules/mod_dir.so ErrorLog "logs/error_log" = ErrorLog /usr/local/apache/logs/error_log Alias /net_path local_fs_path = Alias /net_path /usr/local/apache/local_fs_path Include conf.d/vhost.conf = Include /usr/local/apache/conf.d/vhost.conf
但注意，容器< Directory PATH >的PATH一般设置为文件系统的绝对路径，因为它是路径匹配性质的。但它仍可以使用相对路径时，此时它相对的是根文件系统的"/"，而非ServerRoot。
所以，这个指令强烈不建议做任何修改，修改是很简单，但是牵一发而动全身。
如果说，ServerRoot是httpd中本地文件相对路径的根，那么DocumentRoot就是网络路径相对路径的根。顾名思义，DocumentRoot是文档的根目录，这个文档的意思是展现在网络上的文档。使用rpm包安装的httpd的DocumentRoot默认值为"/var/www"，编译安装的httpd，其DocumentRoot默认为"PREFIX/htdocs"，也就是"$ServerRoot/htdocs"。 设置DocumentRoot后，将需要在网络上访问的文件都放进此目录下即可。 例如，假设httpd所在主机IP为192.168.100.14，DocumentRoot使用默认的/usr/local/apache/htdocs，那么下面几个URL中，左边的是浏览器中输入的值，右边的是其访问的服务器上的资源路径。
http://192.168.100.14/index.html ==> /usr/local/apache/htdocs/index.html http://192.168.100.14/index.php ==> /usr/local/apache/htdocs/index.php http://192.168.100.14/subdir/index.html ==> /usr/local/apache/htdocs/subdir/index.html http://192.168.100.14/subdir/index.php ==> /usr/local/apache/htdocs/subdir/php
也就是说，DocumentRoot的值对应的是http://192.168.100.14/的"/"。
该指令设置的是"当搜索的URL中的路径使用了"/"结尾时，httpd将搜索该指令所指定的文件响应给客户端"。也就是说，当url表示搜索的是目录时，将查找该目录下的DirectoryIndex。注意，很多时候如果没有给定尾部的"/"，httpd的dir_module模块会自行加上"/"，当然，是否补齐尾随的"/"，也是可以控制的，见DirectorySlash指令。
DirectoryIndex的设置格式为：
DirectoryIndex disabled | local-url [local-url]
例如，当设置"DirectoryIndex index.html"时，如果在浏览器中输入下面左边的几个URL，httpd将响应右边对应的文件。
http://192.168.100.14 ==> $DocumentRoot/index.html http://192.168.100.14/newdir/ ==> $DocumentRoot/newdir/index.html
可以指定多个index文件，它们将按顺序从左向右依次查找，并返回第一个找到的index文件。例如：
<IfModule dir_module> DirectoryIndex index.php index.html /mydir/index.html </IfModule>
当浏览器中输入http://192.168.100.14/时，将首先搜索index.php，如果该文件不存在，则再搜索index.html，如果还找不到，则再找该目录的子目录下的文件/mydir/index.html。但这不表示http://192.168.100.14/mydir/会搜索/mydir/index.html。
可以使用多个DirectoryIndex指令进行追加设置，它等价于单行设置多个值，例如下面的设置等价于DirectoryIndex index.php index.html：
DirecotryIndex index.php
DirectoryIndex index.html
如果要替换某个值，则直接修改或使用disabled关键字禁用其前面的Directoryindex。例如禁用index.php，只提供index.html的索引。
DirectoryIndex index.php
DirectoryIndex disabled
DirectoryIndex index.html
但注意，"disabled"关键字必须独自占用一个DirectoryIndex指令，否则它将被解析成字面意思，也就是说将其当作一个index文件响应给客户端。
DirectoryIndex指令可以设置在Server、Virtual host、Location和Directory上下文。所以，当设置在location或Directory容器中时，它将覆盖全局设置。例如，当DocumentRoot为/usr/local/apache/htdocs时：
DirectoryIndex index.php <directory /usr/local/apache/htdocs/newdir> DirectoryIndex index.html </directory> # 或者 <location /newdir> DirectoryIndex index.html </location>
在输入http://IP/newdir/时，将提供index.html而非index.php。
当DirectoryIndex提供的索引文件都不存在时，将根据Options中的Indexes选项设置决定是否列出文件列表，除非是提供文件下载，否则出于安全考虑，这个选项是强烈建议关闭的。例如以下设置为打开，当
<directory /usr/local/apache/htdocs/newdir>
Options Indexes
DirectoryIndex index.html
</directory>
ServerName用于唯一标识提供web服务的主机名，只有在基于名称的虚拟主机中该指令才是必须提供的。也就是说，如果不是在基于名称的虚拟主机中，可以任意指定该指令的值，只要你认为它能唯一标识你的主机。但如果不设置该指令，那么httpd在启动时，将会反解操作系统的IP地址。
唯一标识主机的方式，也即ServerName的语法为：
ServerName {domain-name|ip-address}[:port]
例如，在主机web.longshuai.com上提供了一个httpd web服务，如果还想使用www.longshuai.com提供同样的服务，还想效率更高点，则在设置DNS别名后再配置：
serverName www.longshuai.com
ServerAlias用于定义ServerName的别名。如果在定义ServerName之后再定义ServerAlias，那么ServerName和ServerAlias没有任何区别。当然，为了区分基于名称的虚拟主机，还是必须要定义ServerName。
例如，下面几个ServerName和ServerAlias是完全等价的。
<VirtualHost *:80> ServerName server.example.com ServerAlias server server2.example.com server2 ServerAlias *.example.com # ... </VirtualHost>
在httpd启动时，首先会解析配置文件。httpd支持include指令来包含其他文件，在解析配置文件时会进行配置合并。
支持通配符"*"、"?"和"[]"，但它们不能匹配斜线"/"，如有必要，它们会按照文件名的字母顺序依次进行加载。如果include指令中指定包含一个目录，则会按照字母顺序加载该目录内的所有文件，这比较容易出错，因为有些时候会产生一些临时文件或非配置类的文件。
例如：
Include /usr/local/apache/conf/ssl.conf Include /usr/local/apache/conf/vhosts/*.conf
可以使用绝对路径，也可以使用相对路径，如果使用相对路径，则它相对于ServerRoot。
Include conf/ssl.conf Include conf/vhosts/*.conf
该指令用于定义参数或定义向后全局生效的变量。语法格式为：
Define param [value]
当只给定一个param时，表示定义一个参数，这个参数用于< IfDefine param >容器进行判断，只有定义了的参数param，该容器才返回真，其内封装的指令才生效。它的等价行为是在httpd启动时(必须是启动时)，使用"-D"选项定义参数。例如下面两个方法是等价的：
# startup command shell> httpd -DMyName ...... # in config Define MyName
当给定了两个参数，即还指定了value时，将表示定义一个变量，该变量具有向后全局性。也就是说，定义在某个虚拟主机中的变量在后面的另一个虚拟主机中也有效。引用变量时，使用${var}的方式。注意，变量名中不能包含冒号":"。
例如：
<IfDefine !TEST> Define servername www.example.com </IfDefine> DocumentRoot "/var/www/${servername}/htdocs"
使用UnDefine指令则是取消Define定义的参数或变量。语法为UnDefine param。
无疑，这是最重要的指令之一。用于封装一组指令只作用于指定主机名或IP地址的虚拟主机上。
语法格式为：
<VirtualHost addr[:port] [addr[:port]] ...> ... </VirtualHost>
其中addr部分可以是以下几种情况：
例如：
<VirtualHost 10.1.2.3:80> ServerAdmin webmaster@host.example.com DocumentRoot "/www/docs/host.example.com" ServerName host.example.com ErrorLog "logs/host.example.com-error_log" TransferLog "logs/host.example.com-access_log" </VirtualHost>
需要为虚拟主机指定ServerName，否则它将会从主配置继承。对于基于名称的虚拟主机，ServerName更是不可缺少，否则将继承操作系统的FQDN。
当一个请求到达时，将按照最佳匹配进行主机匹配：通配的内容越少，优先级越高，也就越佳。例如"192.168.100.14:80"的优先级高于"*:80"。如果基于名称的虚拟主机无法匹配上，则采用虚拟主机列表中的第一个虚拟主机作为响应主机。如果所有虚拟主机都无法匹配上，则采用从主配置段落中的主机，如果主配置段落中注释了DocumentRoot，则返回对应的错误。
具体配置方法，见配置httpd虚拟主机。
Options启用或禁用指定目录下的某些特性。有效值包括：All、None、ExecCGI、FollowSymLinks、Includes、IncludesNOEXEC、Indexes、MultiViews、SymLinksIfOwnerMatch。
不指定options时，默认为all。一般除了提供下载服务会开启一个Indexes选项，其他选项都会关掉，即使用：
Options None
AllowOverride指令用于控制是否读取".htaccess"配置文件。
如何设置这个指令要看具体情况，有以下几种值，此外还可以设置为all和none，表示启用、禁用所有特性。
例如下面的指令使得在使用非认证类和索引控制类指令时，将产生服务器类的错误。
AllowOverride AuthConfig Indexes
该指令只能放在Directory容器中，用于控制对目录的访问权限。它的主要功能是由mod_authz_core模块提供，但有些身份认证类模块也提供它额外的功能，这时它可以放在< Directory >、< Files >或< Location >容器中。
主要功能：
身份认证类模块提供的require指令功能包括：
可以在require指令后紧跟not关键字，表示取反。例如"require not group group1"、"require not local"等。
还支持require条件容器，包括< RequireAll >、< RequireAny >和< RequireNone >，当require指令没有写在任何Require容器中时，它们隐式包含在一个< RequireAny >容器中。
KeepAlive指令用于开启和关闭长连接功能。
KeepAlive on/off
在没有开启长连接时，客户端每请求一个资源都需重新建立一次TCP连接，而使用了长连接后，客户端只需在最初请求一次TCP连接，之后就可以使用同一个TCP连接发送其他的http请求。长连接的状态是指在服务端处理完某一个请求后，它立即进入长连接状态以保持TCP连接不断开，等待客户端再次发送请求。
但长连接自身的缺陷是会一直占用着连接不释放，所以必须得给出一个长连接的超时时间。这个超时时间由KeepAliveTimeout指令控制，进入长连接后如果在此时间间隔内客户端还没有发送新请求，则TCP连接自动断开。如果在长连接状态下，客户端再次发送了请求，则服务端处理请求，并在处理完请求后又再次进入长连接状态并计算KeepAliveTimeout。
此外，还可以通过指令MaxKeepAliveRequests控制每个长连接下的TCP连接的能接受的最大请求数。无疑，这个值应该设置的大一些，设置为0表示无限制。这个指令是从数量的角度控制长连接的TCP应该何时断开。例如，在长连接超时时间内接受同一个客户端的500个请求才断开，然后该客户端再有新的请求只能重新建立TCP连接。
MaxKeepAliveRequests 500
路径和条件判断容器包括：
还包括它们的正则匹配容器< DirectoryMatch >、< FilesMatch >。
< Directory >容器的作用是"对于匹配到的目录，封装一组指令，这些指令只作用于该目录以及它的子目录中的文件"。注意，< Directory >容器通常都是用绝对路径，即< Directory /PATH/to/DIR >，如果使用相对路径，则它相对于根文件系统的"/"。例如< directory newdir >等价于< directory /newdir >。
<Directory "/"> AllowOverride none require all denied </Directory> <Directory "/usr/local/apache/htdocs"> require all granted </Directory>
第一个容器表示拒绝所有对"/"下内容的访问，包括子目录中的文件，这个根是根文件系统的根，而不是ServerRoot。而第二个容器则表示允许/usr/local/apache/htdocs目录下文件的访问。
由此可以想象得出，出于安全考虑，应该总是先将父目录进行限制，再在需要放宽权限的子目录中指定特定的权限。正如上面的设置，将最顶级目录"/"完全限制，然后在小范围的htdocs目录中放行。
再看< Files >容器，它针对的是某个或某些特定的能被匹配上的文件。它匹配的范围是它所在的上下文。
例如，下面的指令如果写在server上下文，那么将对任意private.html文件拒绝。
<Files private.html>
require all denied
</Files>
而如果将其写在< directory >容器中，则只对该目录容器中的所有private.html生效。由于< directory >会递归到子目录中，所以子目录中的private.html也会拒绝，但非private.html将被允许。
<Directory "/usr/local/apache/htdocs"> require all granted <Files private.html> require all denied </Files> </Directory>
< directory >和< files >容器可以使用通配符，"*"表示任意字符，"?"表示任意单个字符，"[]"表示范围，如[a-z]、[0-9]，但是这些通配符都不能匹配"/"。所以要跨目录匹配时，必须显式指定各个目录的"/"符号。
例如，<directory /*/public.html>无法匹配/home/user/public.html，但directory /home/*/public.html可以匹配。
它还可以使用正则表达式匹配，只需使用一个"~"符号即可。这时和使用< DirectoryMatch >、< FilesMatch >是一样的，只不过Match类指令不需要使用"~"符号。
例如，下面的设置。其中后两个Directory容器是等价的。
# 匹配不区分大小写的gif/jpg/jpeg/png <FilesMatch "\.(?i:gif|jpe?g|png)$"> Require all denied </FilesMatch> <Directory ~ "^/usr/local/apache/htdocs/[0-9]{3}"> DirectoryIndex digest.html </Directory> <DirectoryMatch "^/usr/local/apache/htdocs/[0-9]{3}"> DirectoryIndex digest.html </DirectoryMatch>
需要注意的是，httpd采用的pcre库提供的perl兼容正则。以下是官方手册提供的一个示例，使用的命名捕获语法，它将匹配/var/www/combined/目录下的一级子目录，但不进行递归。将每个匹配到的结果保存到命名的分组sitename中，并通过环境变量"MATCH_capturename"进行引用，其中capturename必须转为大写字母，因为它就是这样赋值的。
<DirectoryMatch "^/var/www/combined/(?<sitename>[^/]+)"> Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example </DirectoryMatch>
目前已经不能使用未命名的后向引用，例如$0,$1...。在URL重写时，正则语法至关重要，像grep/sed/awk中天然支持的基础正则和扩展正则语法虽然能解决大部分问题，但想要实现复杂的需求，只能使用语义丰富、完整的正则，如pcre提供的正则。
该容器和< Directory >、< Files >容器差不多，都是对满足匹配条件的路径封装一组指令，这些指令只生效于这些能匹配的路径。但是< Location >和< Directory >、< Files >最大的区别是：前者匹配的目标是WebSpace，即匹配URL中的路径，而后两者匹配的是本地文件系统的路径。
标签：rpm安装 ini min link expr 字符 spec rri 相对路径
原文地址：https://www.cnblogs.com/liujunjun/p/12048982.html
