#
# 这是 Apache HTTP 服务器主配置文件. 它包含用于服务器配置的相关命令.
# 详细信息请见 <URL:http://httpd.apache.org/docs/2.4/> 
# 最重要的是仔细查看 <URL:http://httpd.apache.org/docs/2.4/mod/directives.html>
# 中关于每个配置指令的讨论.
#
# 不要在这简单的阅读指令而不了解他们的具体作用.他们在这里仅仅是提示或提醒. 
# 如果你不确定可以查阅在线文档. 请一定要注意.
#
# 配置和日志文件名称: 
# 如果你对许多服务器控制文件的文件名指定以"/"(或是 Windows 中"盘符:/")开始，
# 服务器将会使用显式路径.如果文件名不是以"/"开始的,ServerRoot值将用于前缀
# 例如 "logs/access_log" 当 ServerRoot 设置为 "/usr/local/apache2"时
# 将由服务器解释为 "/usr/local/apache2/logs/access_log",
# 然而 "/logs/access_log" 将会解释为 '/logs/access_log'.
# 
# Vlongen：这傻逼都是知道的事居然要重申一遍，Apache 团队可能是用行数考核 KPI
# 

#
# ServerRoot: 这个服务器的配置文件,错误文件,以及日志文件目录树的顶级根目录
#
# 不要在目录的结尾添加一个斜线(“/”).如果你指向的 ServerRoot 在一个非本地磁盘上, 
# 那么一定要用互斥指令指定一个本地磁盘,如果基于文件的互斥已被占用(这特么什么意思?).
# 如果你希望多个 httpd 守护进程共享 ServerRoot, 你至少需要修改PidFile(这又是啥?).
#
ServerRoot "/usr"

#
# 互斥(Mutex): 允许你为特定的互斥器设置互斥机制和互斥文件目录,或者改变全局默认值.
#
# 如果互斥器是基于文件和默认互斥文件目录不在本地磁盘或者是因为一些其他的原因不合适，
# 你就可以取消注释并修改目录.
#
# Mutex default:/private/var/run

#
# 侦听(Listen): 允许你绑定 Apache 到特定的 IP 地址和端口代替默认值.
# 另请参阅 <VirtualHost> 指令.
# 
# 改变这个配置来镇定指定的 IP 地址如下所示,防止 Apache 扫描到的所有 IP 地址.
#
#Listen 12.34.56.78:80
Listen 80

#
# 支持动态共享对象 (DSO)
#  
# 为了能够使用那些以DSO模式编译的模块中的功能,你必须找到对应的'LoadModule'行位置
# 在这里包含了这些指令，以便能在使用它之前激活。
# 静态编译的模块(那些列出'httpd -l'的)不需要在这里加载.
#
# 例如:
# LoadModule foo_module modules/mod_foo.so
#
LoadModule authn_file_module libexec/apache2/mod_authn_file.so
#LoadModule authn_dbm_module libexec/apache2/mod_authn_dbm.so
#LoadModule authn_anon_module libexec/apache2/mod_authn_anon.so
#LoadModule authn_dbd_module libexec/apache2/mod_authn_dbd.so
#LoadModule authn_socache_module libexec/apache2/mod_authn_socache.so
LoadModule authn_core_module libexec/apache2/mod_authn_core.so
LoadModule authz_host_module libexec/apache2/mod_authz_host.so
LoadModule authz_groupfile_module libexec/apache2/mod_authz_groupfile.so
LoadModule authz_user_module libexec/apache2/mod_authz_user.so
#LoadModule authz_dbm_module libexec/apache2/mod_authz_dbm.so
#LoadModule authz_owner_module libexec/apache2/mod_authz_owner.so
#LoadModule authz_dbd_module libexec/apache2/mod_authz_dbd.so
LoadModule authz_core_module libexec/apache2/mod_authz_core.so
#LoadModule authnz_ldap_module libexec/apache2/mod_authnz_ldap.so
LoadModule access_compat_module libexec/apache2/mod_access_compat.so
LoadModule auth_basic_module libexec/apache2/mod_auth_basic.so
#LoadModule auth_form_module libexec/apache2/mod_auth_form.so
#LoadModule auth_digest_module libexec/apache2/mod_auth_digest.so
#LoadModule allowmethods_module libexec/apache2/mod_allowmethods.so
#LoadModule file_cache_module libexec/apache2/mod_file_cache.so
#LoadModule cache_module libexec/apache2/mod_cache.so
#LoadModule cache_disk_module libexec/apache2/mod_cache_disk.so
#LoadModule cache_socache_module libexec/apache2/mod_cache_socache.so
#LoadModule socache_shmcb_module libexec/apache2/mod_socache_shmcb.so
#LoadModule socache_dbm_module libexec/apache2/mod_socache_dbm.so
#LoadModule socache_memcache_module libexec/apache2/mod_socache_memcache.so
#LoadModule watchdog_module libexec/apache2/mod_watchdog.so
#LoadModule macro_module libexec/apache2/mod_macro.so
#LoadModule dbd_module libexec/apache2/mod_dbd.so
#LoadModule dumpio_module libexec/apache2/mod_dumpio.so
#LoadModule echo_module libexec/apache2/mod_echo.so
#LoadModule buffer_module libexec/apache2/mod_buffer.so
#LoadModule data_module libexec/apache2/mod_data.so
#LoadModule ratelimit_module libexec/apache2/mod_ratelimit.so
LoadModule reqtimeout_module libexec/apache2/mod_reqtimeout.so
#LoadModule ext_filter_module libexec/apache2/mod_ext_filter.so
#LoadModule request_module libexec/apache2/mod_request.so
#LoadModule include_module libexec/apache2/mod_include.so
LoadModule filter_module libexec/apache2/mod_filter.so
#LoadModule reflector_module libexec/apache2/mod_reflector.so
#LoadModule substitute_module libexec/apache2/mod_substitute.so
#LoadModule sed_module libexec/apache2/mod_sed.so
#LoadModule charset_lite_module libexec/apache2/mod_charset_lite.so
#LoadModule deflate_module libexec/apache2/mod_deflate.so
#LoadModule xml2enc_module libexec/apache2/mod_xml2enc.so
#LoadModule proxy_html_module libexec/apache2/mod_proxy_html.so
LoadModule mime_module libexec/apache2/mod_mime.so
#LoadModule ldap_module libexec/apache2/mod_ldap.so
LoadModule log_config_module libexec/apache2/mod_log_config.so
#LoadModule log_debug_module libexec/apache2/mod_log_debug.so
#LoadModule log_forensic_module libexec/apache2/mod_log_forensic.so
#LoadModule logio_module libexec/apache2/mod_logio.so
LoadModule env_module libexec/apache2/mod_env.so
#LoadModule mime_magic_module libexec/apache2/mod_mime_magic.so
#LoadModule expires_module libexec/apache2/mod_expires.so
LoadModule headers_module libexec/apache2/mod_headers.so
#LoadModule usertrack_module libexec/apache2/mod_usertrack.so
##LoadModule unique_id_module libexec/apache2/mod_unique_id.so
LoadModule setenvif_module libexec/apache2/mod_setenvif.so
LoadModule version_module libexec/apache2/mod_version.so
#LoadModule remoteip_module libexec/apache2/mod_remoteip.so
LoadModule proxy_module libexec/apache2/mod_proxy.so
LoadModule proxy_connect_module libexec/apache2/mod_proxy_connect.so
LoadModule proxy_ftp_module libexec/apache2/mod_proxy_ftp.so
LoadModule proxy_http_module libexec/apache2/mod_proxy_http.so
LoadModule proxy_fcgi_module libexec/apache2/mod_proxy_fcgi.so
LoadModule proxy_scgi_module libexec/apache2/mod_proxy_scgi.so
#LoadModule proxy_fdpass_module libexec/apache2/mod_proxy_fdpass.so
LoadModule proxy_wstunnel_module libexec/apache2/mod_proxy_wstunnel.so
LoadModule proxy_ajp_module libexec/apache2/mod_proxy_ajp.so
LoadModule proxy_balancer_module libexec/apache2/mod_proxy_balancer.so
LoadModule proxy_express_module libexec/apache2/mod_proxy_express.so
#LoadModule session_module libexec/apache2/mod_session.so
#LoadModule session_cookie_module libexec/apache2/mod_session_cookie.so
#LoadModule session_dbd_module libexec/apache2/mod_session_dbd.so
LoadModule slotmem_shm_module libexec/apache2/mod_slotmem_shm.so
#LoadModule slotmem_plain_module libexec/apache2/mod_slotmem_plain.so
#LoadModule ssl_module libexec/apache2/mod_ssl.so
#LoadModule dialup_module libexec/apache2/mod_dialup.so
LoadModule lbmethod_byrequests_module libexec/apache2/mod_lbmethod_byrequests.so
LoadModule lbmethod_bytraffic_module libexec/apache2/mod_lbmethod_bytraffic.so
LoadModule lbmethod_bybusyness_module libexec/apache2/mod_lbmethod_bybusyness.so
#LoadModule lbmethod_heartbeat_module libexec/apache2/mod_lbmethod_heartbeat.so
LoadModule unixd_module libexec/apache2/mod_unixd.so
#LoadModule heartbeat_module libexec/apache2/mod_heartbeat.so
#LoadModule heartmonitor_module libexec/apache2/mod_heartmonitor.so
#LoadModule dav_module libexec/apache2/mod_dav.so
LoadModule status_module libexec/apache2/mod_status.so
LoadModule autoindex_module libexec/apache2/mod_autoindex.so
#LoadModule asis_module libexec/apache2/mod_asis.so
#LoadModule info_module libexec/apache2/mod_info.so
#LoadModule cgi_module libexec/apache2/mod_cgi.so
#LoadModule dav_fs_module libexec/apache2/mod_dav_fs.so
#LoadModule dav_lock_module libexec/apache2/mod_dav_lock.so
#LoadModule vhost_alias_module libexec/apache2/mod_vhost_alias.so
LoadModule negotiation_module libexec/apache2/mod_negotiation.so
LoadModule dir_module libexec/apache2/mod_dir.so
#LoadModule imagemap_module libexec/apache2/mod_imagemap.so
#LoadModule actions_module libexec/apache2/mod_actions.so
#LoadModule speling_module libexec/apache2/mod_speling.so
#LoadModule userdir_module libexec/apache2/mod_userdir.so
LoadModule alias_module libexec/apache2/mod_alias.so
#LoadModule rewrite_module libexec/apache2/mod_rewrite.so
LoadModule php5_module libexec/apache2/libphp5.so
LoadModule hfs_apple_module libexec/apache2/mod_hfs_apple.so

<IfModule unixd_module>
#
# 如果你希望 httpd 以不同的用户或用户组来运行, 你必须在开始时使用 root 运行 httpd 它将会自动切换.  
# 
#
# User/Group:运行 httpd 的User/Group名称(或 #编号).
# 和大多数系统服务一样,创建一个专用的用户和用户组来运行 httpd 通常是最良好的选择.
#
User _www
Group _www

</IfModule>

# 'Main' 主服务器配置
# 
# 这个部分设置主服务器所使用的值,响应任何没有在<VirtualHost>中定义处理的请求.
# 这些值也提供给你可以之后在文件中定义的<VirtualHost> 容器作为默认值.
# 
# 所有这些指令都可能出现在<VirtualHost>容器里,在这种情况下这些设置将重写<VirtualHost>的默认定义.
#

#
# ServerAdmin: 你的地址, 当发生问题时 Apache 将向你发出邮件.
# 他的地址将出现在一些服务器生成的页面, 如错误文档.
# 例如 admin@your-domain.com
#
ServerAdmin vlongen@vlongen.com

#
# ServerName 指定用于Apache识别自身的名称和端口号.
# 这通常可以自动确定, 但是我们推荐您显式的指定它以防止启动时出现错误.
#
# 如果你没有注册一个 DNS 域名, 可以在这里输入 IP 地址.
#
#ServerName www.example.com:80

#
# 完全拒绝访问您服务器的文件系统.你必须在其他的<Directory>块中显式地允许访问到您 Web 内容目录.
#
<Directory />
    AllowOverride none
    Require all denied
</Directory>

#
# 注意从这里开始你一定要明确地允许哪些特别的特征能够被使用.所以，如果Apache没有象你所期待的那样工作的话,
# 请检查你是否在下面明确的指定它可用。
# 

#
# DocumentRoot: 你的文档的根目录。默认情况下，所有的请求从这个目录进行应答. 
# 但是可以使用符号链接和别名来指向到其他的位置.
#
DocumentRoot "/Library/WebServer/Documents"
<Directory "/Library/WebServer/Documents">
    #
    # 这个选项指令可能的值是 "None", "All",
    # 或者任意组合:
    #   Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
    #
    # 请注意 "MultiViews" 必须显式命名 --- "Options All" 不能为你提供这个特性.
    #
    # 这个选项指令即复杂又重要.请参见http://httpd.apache.org/docs/2.4/mod/core.html#options
    # 以获取更多信息.
    #
    Options FollowSymLinks Multiviews
    MultiviewsMatch Any

    #
    # AllowOverride控制那些有可能被放置在.htaccess文件中的指令.
    # 它可以是 "All", "None", 或下面任何指令的组合:
    #   AllowOverride FileInfo AuthConfig Limit
    #
    AllowOverride None

    #
    # 控制谁可以获得服务.
    #
    Require all granted
</Directory>

#
# DirectoryIndex: 设置Apache向用户提供服务的索引文件.
# 
#
<IfModule dir_module>
    DirectoryIndex index.html index.php
</IfModule>

#
# 下面的行防止.htaccess和.htpasswd文件被Web客户端查看. 
#
<FilesMatch "^\.([Hh][Tt]|[Dd][Ss]_[Ss])">
    Require all denied
</FilesMatch>

#
# Apple 特定的文件保护系统.
#
<Files "rsrc">
    Require all denied
</Files>
<DirectoryMatch ".*\.\.namedfork">
    Require all denied
</DirectoryMatch>

#
# ErrorLog: 错误日志文件定位.
# 如果你没有在内定义ErrorLog指令，这个虚拟主机的错误信息将记录在这里。如果你在那儿定义了ErrorLog，
# 这些错误信息将记录在你所定义的文件里，而不是这儿定义的文件。
#
ErrorLog "/private/var/log/apache2/error_log"

#
# LogLevel: 控制记录在错误日志文件中的日志信息级别.
# 可能的值包括: debug, info, notice, warn, error, crit,alert, emerg.
#
LogLevel warn

<IfModule log_config_module>
    #
    # 下面的指令为CustomLog指令定义格式别名 (见下文).
    #
    LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
    LogFormat "%h %l %u %t \"%r\" %>s %b" common

    <IfModule logio_module>
      #  你需要启用 mod_logio.c 模块才能使用 %I 和 %O
      LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" combinedio
    </IfModule>

    #
    # 指定接入日志文件的定位和格式（一般日志格式）。
    # 如果你没有在内定义这个指令，传输信息将记录在这里，如果你定义了这个指令，则记录在你指定的位置，而不是这儿定义的位置。
    #
    CustomLog "/private/var/log/apache2/access_log" common

    #
    # 如果你想要记录agent和referer信息，可以使用下面的指令.
    #
    #CustomLog "/private/var/log/apache2/access_log" combined
</IfModule>

<IfModule alias_module>
    #
    # 重定向(Redirect)：允许你告诉客户端使用存在于服务器名字空间中的文档，但不要做更多.这帮助客户端定位那些改变了位置的文档.
    # 例如：
    # Redirect permanent /foo http://www.example.com/bar

    #
    # 别名(Alias): 将Web路径映射到文件系统路径，用于访问不在DocumentRoot之下的内容.
    # 例如:
    # Alias /webpath /full/filesystem/path
    #
    # 如果你在'/webpath'的末尾包含了一个'/'那么服务器的 URL 中也需要包含'/'.
    # 你也可能需要提供一个<Directory>块去允许文件系统路径的访问.

    #
    # ScriptAlias: 指定包含服务脚本的目录. 
    # ScriptAliases本质上与Aliases一样, 除了这里的文档在请求时做为程序处理处理以外,尾部的“/”规则与Alias一样.
    #
    ScriptAliasMatch ^/cgi-bin/((?!(?i:webobjects)).*$) "/Library/WebServer/CGI-Executables/$1"

</IfModule>

<IfModule cgid_module>
    #
    # ScriptSock: 在线程服务器上, 指定路径到 UNIX 套接字使用CGI进程的mod_cgid模块进行通讯.
    #
    #Scriptsock cgisock
</IfModule>

#
# "/Library/WebServer/CGI-Executables" 应该修改为ScriptAliased指定的CGI目录, 如果你有这样的配置.
# 
#
<Directory "/Library/WebServer/CGI-Executables">
    AllowOverride None
    Options None
    Require all granted
</Directory>

<IfModule mime_module>
    #
    # TypesConfig 表明该文件包含从文件扩展名映射到 MIME 类型的列表.
    # 
    #
    TypesConfig /private/etc/apache2/mime.types

    #
    # AddType 允许你为指定的文件类型在TypesConfig中添加或覆盖 MIME 配置文件
    #
    #AddType application/x-gzip .tgz
    #
    # AddEncoding 允许你在某些浏览器信息传送过程中解压缩信息.注意:不是所有浏览器都支持这个功能.
    #
    #AddEncoding x-compress .Z
    #AddEncoding x-gzip .gz .tgz
    #
    # 如果以上 AddEncoding 指令注释掉了,然后你或许应该定义那些扩展来显示媒体类型.
    #
    AddType application/x-compress .Z
    AddType application/x-gzip .gz .tgz

    #
    # AddHandler 允许你映射某些文件扩展到“处理程序”(handlers):
    # 与文件类型无关的行为.这些可以是内置在服务器或添加的行动指令(见下文)
    #
    # 为了在ScriptAliased指令指定的以外使用CGI脚本：
    # (你将也需要添加"ExecCGI"到"Options"指令.)
    #
    #AddHandler cgi-script .cgi

    # 对于类型映射 (协商资源):
    #AddHandler type-map var

    #
    # 过滤器允许你在它发送到客户端之前处理内容.
    # 
    # 对于在服务器端解析包含(SSI) 的.shtml 文件:
    # (你将也需要添加 "Includes" 到 "Options" 指令.)
    #
    #AddType text/html .shtml
    #AddOutputFilter INCLUDES .shtml
</IfModule>

#
# 这个 mod_mime_magic 模块允许服务器使用多种提示,这些提示来自文件自身内容用来定义它自己的类型.  
# 而这个 MIMEMagicFile 指令告诉模块位于提示定义的位置.
#
#MIMEMagicFile /private/etc/apache2/magic

#
# 可定制的错误响应支持三种方式:
# 1) plain text 2) local redirects 3) external redirects
#
# 一些示例:
#ErrorDocument 500 "The server made a boo boo."
#ErrorDocument 404 /missing.html
#ErrorDocument 404 "/cgi-bin/missing_handler.pl"
#ErrorDocument 402 http://www.example.com/subscription_info.html
#

#
# MaxRanges: 定义了在一个请求返回全部资源之前Ranges的最大数字，或者在'default', 'none' or 'unlimited'三个值中指定的一个值.
#MaxRanges unlimited

#
# EnableMMAP 和 EnableSendfile:在支持它的系统上, 内存映射或者发送文件系统调用可能被用于传送文件.
# 这通常会提高服务器性能,但是当服务从网络安装文件系统或如果这些功能在您的系统上损坏时必须关闭.
# 
# 默认值: EnableMMAP On, EnableSendfile Off
#
#EnableMMAP off
#EnableSendfile on

TraceEnable off

# 补充配置:
# 
# 这些配置文件在 /private/etc/apache2/extra/ 目录可以被包含以添加额外的功能或是修改默认服务器配置,
# 或者你可以在必要时在这简单的复制他们的内容和修改.
# 

# 服务器池管理 (MPM特性)
Include /private/etc/apache2/extra/httpd-mpm.conf

# 多语言错误
#Include /private/etc/apache2/extra/httpd-multilang-errordoc.conf

# 动态目录列表形式配置
Include /private/etc/apache2/extra/httpd-autoindex.conf

# 语言设置
#Include /private/etc/apache2/extra/httpd-languages.conf

# 用户本地目录配置
#Include /private/etc/apache2/extra/httpd-userdir.conf

# 关于请求和配置的实时信息
#Include /private/etc/apache2/extra/httpd-info.conf

# 虚拟主机
Include /private/etc/apache2/extra/httpd-vhosts.conf

# 本地访问 Apache HTTP 服务器指南
#Include /private/etc/apache2/extra/httpd-manual.conf

# 分布式创作和版本控制 (WebDAV)
#Include /private/etc/apache2/extra/httpd-dav.conf

# 各种默认设置
#Include /private/etc/apache2/extra/httpd-default.conf

# 配置 mod_proxy_html 以支持 HTML4/XHTML1
<IfModule proxy_html_module>
Include /private/etc/apache2/extra/proxy-html.conf
</IfModule>

# 安全的 (SSL/TLS) 连接
#Include /private/etc/apache2/extra/httpd-ssl.conf
#
# 注意: 以下必须在没有类似 /dev/random 的平台上支持无 SSL 加密的启动,但是mod_ssl一个静态的内编译.
#
<IfModule ssl_module>
SSLRandomSeed startup builtin
SSLRandomSeed connect builtin
</IfModule>

Include /private/etc/apache2/other/*.conf

#
# 取消以下注释处理用户代理故意违反使用 DNT 开放标准(DNT必须是一个特定的最终用户的选择) 
#
#<IfModule setenvif_module>
#BrowserMatch "MSIE 10.0;" bad_DNT
#</IfModule>
#<IfModule headers_module>
#RequestHeader unset DNT env=bad_DNT
#</IfModule>