#
# 這是 Apache HTTP 服務(wù)器主配置文件. 它包含用于服務(wù)器配置的相關(guān)命令.
# 詳細(xì)信息請見 <URL:http://httpd.apache.org/docs/2.4/> 
# 最重要的是仔細(xì)查看 <URL:http://httpd.apache.org/docs/2.4/mod/directives.html>
# 中關(guān)于每個配置指令的討論.
#
# 不要在這簡單的閱讀指令而不了解他們的具體作用.他們在這里僅僅是提示或提醒. 
# 如果你不確定可以查閱在線文檔. 請一定要注意.
#
# 配置和日志文件名稱: 
# 如果你對許多服務(wù)器控制文件的文件名指定以"/"(或是 Windows 中"盤符:/")開始待诅，
# 服務(wù)器將會使用顯式路徑.如果文件名不是以"/"開始的,ServerRoot值將用于前綴
# 例如 "logs/access_log" 當(dāng) ServerRoot 設(shè)置為 "/usr/local/apache2"時(shí)
# 將由服務(wù)器解釋為 "/usr/local/apache2/logs/access_log",
# 然而 "/logs/access_log" 將會解釋為 '/logs/access_log'.
# 
# Vlongen：這傻逼都是知道的事居然要重申一遍设凹，Apache 團(tuán)隊(duì)可能是用行數(shù)考核 KPI
# 

#
# ServerRoot: 這個服務(wù)器的配置文件,錯誤文件,以及日志文件目錄樹的頂級根目錄
#
# 不要在目錄的結(jié)尾添加一個斜線(“/”).如果你指向的 ServerRoot 在一個非本地磁盤上, 
# 那么一定要用互斥指令指定一個本地磁盤,如果基于文件的互斥已被占用(這特么什么意思?).
# 如果你希望多個 httpd 守護(hù)進(jìn)程共享 ServerRoot, 你至少需要修改PidFile(這又是啥?).
#
ServerRoot "/usr"

#
# 互斥(Mutex): 允許你為特定的互斥器設(shè)置互斥機(jī)制和互斥文件目錄,或者改變?nèi)帜J(rèn)值.
#
# 如果互斥器是基于文件和默認(rèn)互斥文件目錄不在本地磁盤或者是因?yàn)橐恍┢渌脑虿缓线m，
# 你就可以取消注釋并修改目錄.
#
# Mutex default:/private/var/run

#
# 偵聽(Listen): 允許你綁定 Apache 到特定的 IP 地址和端口代替默認(rèn)值.
# 另請參閱 <VirtualHost> 指令.
# 
# 改變這個配置來鎮(zhèn)定指定的 IP 地址如下所示,防止 Apache 掃描到的所有 IP 地址.
#
#Listen 12.34.56.78:80
Listen 80

#
# 支持動態(tài)共享對象 (DSO)
#  
# 為了能夠使用那些以DSO模式編譯的模塊中的功能,你必須找到對應(yīng)的'LoadModule'行位置
# 在這里包含了這些指令鹦聪，以便能在使用它之前激活鬓照。
# 靜態(tài)編譯的模塊(那些列出'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 以不同的用戶或用戶組來運(yùn)行, 你必須在開始時(shí)使用 root 運(yùn)行 httpd 它將會自動切換.  
# 
#
# User/Group:運(yùn)行 httpd 的User/Group名稱(或 #編號).
# 和大多數(shù)系統(tǒng)服務(wù)一樣,創(chuàng)建一個專用的用戶和用戶組來運(yùn)行 httpd 通常是最良好的選擇.
#
User _www
Group _www

</IfModule>

# 'Main' 主服務(wù)器配置
# 
# 這個部分設(shè)置主服務(wù)器所使用的值,響應(yīng)任何沒有在<VirtualHost>中定義處理的請求.
# 這些值也提供給你可以之后在文件中定義的<VirtualHost> 容器作為默認(rèn)值.
# 
# 所有這些指令都可能出現(xiàn)在<VirtualHost>容器里,在這種情況下這些設(shè)置將重寫<VirtualHost>的默認(rèn)定義.
#

#
# ServerAdmin: 你的地址, 當(dāng)發(fā)生問題時(shí) Apache 將向你發(fā)出郵件.
# 他的地址將出現(xiàn)在一些服務(wù)器生成的頁面, 如錯誤文檔.
# 例如 admin@your-domain.com
#
ServerAdmin vlongen@vlongen.com

#
# ServerName 指定用于Apache識別自身的名稱和端口號.
# 這通称可以自動確定, 但是我們推薦您顯式的指定它以防止啟動時(shí)出現(xiàn)錯誤.
#
# 如果你沒有注冊一個 DNS 域名, 可以在這里輸入 IP 地址.
#
#ServerName www.example.com:80

#
# 完全拒絕訪問您服務(wù)器的文件系統(tǒng).你必須在其他的<Directory>塊中顯式地允許訪問到您 Web 內(nèi)容目錄.
#
<Directory />
    AllowOverride none
    Require all denied
</Directory>

#
# 注意從這里開始你一定要明確地允許哪些特別的特征能夠被使用.所以惶室，如果Apache沒有象你所期待的那樣工作的話,
# 請檢查你是否在下面明確的指定它可用斋枢。
# 

#
# DocumentRoot: 你的文檔的根目錄帘靡。默認(rèn)情況下，所有的請求從這個目錄進(jìn)行應(yīng)答. 
# 但是可以使用符號鏈接和別名來指向到其他的位置.
#
DocumentRoot "/Library/WebServer/Documents"
<Directory "/Library/WebServer/Documents">
    #
    # 這個選項(xiàng)指令可能的值是 "None", "All",
    # 或者任意組合:
    #   Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
    #
    # 請注意 "MultiViews" 必須顯式命名 --- "Options All" 不能為你提供這個特性.
    #
    # 這個選項(xiàng)指令即復(fù)雜又重要.請參見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

    #
    # 控制誰可以獲得服務(wù).
    #
    Require all granted
</Directory>

#
# DirectoryIndex: 設(shè)置Apache向用戶提供服務(wù)的索引文件.
# 
#
<IfModule dir_module>
    DirectoryIndex index.html index.php
</IfModule>

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

#
# Apple 特定的文件保護(hù)系統(tǒng).
#
<Files "rsrc">
    Require all denied
</Files>
<DirectoryMatch ".*\.\.namedfork">
    Require all denied
</DirectoryMatch>

#
# ErrorLog: 錯誤日志文件定位.
# 如果你沒有在內(nèi)定義ErrorLog指令瓤帚，這個虛擬主機(jī)的錯誤信息將記錄在這里描姚。如果你在那兒定義了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>

    #
    # 指定接入日志文件的定位和格式（一般日志格式）。
    # 如果你沒有在內(nèi)定義這個指令怯邪，傳輸信息將記錄在這里绊寻，如果你定義了這個指令，則記錄在你指定的位置悬秉，而不是這兒定義的位置澄步。
    #
    CustomLog "/private/var/log/apache2/access_log" common

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

<IfModule alias_module>
    #
    # 重定向(Redirect)：允許你告訴客戶端使用存在于服務(wù)器名字空間中的文檔和泌，但不要做更多.這幫助客戶端定位那些改變了位置的文檔.
    # 例如：
    # Redirect permanent /foo http://www.example.com/bar

    #
    # 別名(Alias): 將Web路徑映射到文件系統(tǒng)路徑村缸，用于訪問不在DocumentRoot之下的內(nèi)容.
    # 例如:
    # Alias /webpath /full/filesystem/path
    #
    # 如果你在'/webpath'的末尾包含了一個'/'那么服務(wù)器的 URL 中也需要包含'/'.
    # 你也可能需要提供一個<Directory>塊去允許文件系統(tǒng)路徑的訪問.

    #
    # ScriptAlias: 指定包含服務(wù)腳本的目錄. 
    # ScriptAliases本質(zhì)上與Aliases一樣, 除了這里的文檔在請求時(shí)做為程序處理處理以外,尾部的“/”規(guī)則與Alias一樣.
    #
    ScriptAliasMatch ^/cgi-bin/((?!(?i:webobjects)).*$) "/Library/WebServer/CGI-Executables/$1"

</IfModule>

<IfModule cgid_module>
    #
    # ScriptSock: 在線程服務(wù)器上, 指定路徑到 UNIX 套接字使用CGI進(jìn)程的mod_cgid模塊進(jìn)行通訊.
    #
    #Scriptsock cgisock
</IfModule>

#
# "/Library/WebServer/CGI-Executables" 應(yīng)該修改為ScriptAliased指定的CGI目錄, 如果你有這樣的配置.
# 
#
<Directory "/Library/WebServer/CGI-Executables">
    AllowOverride None
    Options None
    Require all granted
</Directory>

<IfModule mime_module>
    #
    # TypesConfig 表明該文件包含從文件擴(kuò)展名映射到 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 指令注釋掉了,然后你或許應(yīng)該定義那些擴(kuò)展來顯示媒體類型.
    #
    AddType application/x-compress .Z
    AddType application/x-gzip .gz .tgz

    #
    # AddHandler 允許你映射某些文件擴(kuò)展到“處理程序”(handlers):
    # 與文件類型無關(guān)的行為.這些可以是內(nèi)置在服務(wù)器或添加的行動指令(見下文)
    #
    # 為了在ScriptAliased指令指定的以外使用CGI腳本：
    # (你將也需要添加"ExecCGI"到"Options"指令.)
    #
    #AddHandler cgi-script .cgi

    # 對于類型映射 (協(xié)商資源):
    #AddHandler type-map var

    #
    # 過濾器允許你在它發(fā)送到客戶端之前處理內(nèi)容.
    # 
    # 對于在服務(wù)器端解析包含(SSI) 的.shtml 文件:
    # (你將也需要添加 "Includes" 到 "Options" 指令.)
    #
    #AddType text/html .shtml
    #AddOutputFilter INCLUDES .shtml
</IfModule>

#
# 這個 mod_mime_magic 模塊允許服務(wù)器使用多種提示,這些提示來自文件自身內(nèi)容用來定義它自己的類型.  
# 而這個 MIMEMagicFile 指令告訴模塊位于提示定義的位置.
#
#MIMEMagicFile /private/etc/apache2/magic

#
# 可定制的錯誤響應(yīng)支持三種方式:
# 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的最大數(shù)字，或者在'default', 'none' or 'unlimited'三個值中指定的一個值.
#MaxRanges unlimited

#
# EnableMMAP 和 EnableSendfile:在支持它的系統(tǒng)上, 內(nèi)存映射或者發(fā)送文件系統(tǒng)調(diào)用可能被用于傳送文件.
# 這通常會提高服務(wù)器性能,但是當(dāng)服務(wù)從網(wǎng)絡(luò)安裝文件系統(tǒng)或如果這些功能在您的系統(tǒng)上損壞時(shí)必須關(guān)閉.
# 
# 默認(rèn)值: EnableMMAP On, EnableSendfile Off
#
#EnableMMAP off
#EnableSendfile on

TraceEnable off

# 補(bǔ)充配置:
# 
# 這些配置文件在 /private/etc/apache2/extra/ 目錄可以被包含以添加額外的功能或是修改默認(rèn)服務(wù)器配置,
# 或者你可以在必要時(shí)在這簡單的復(fù)制他們的內(nèi)容和修改.
# 

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

# 多語言錯誤
#Include /private/etc/apache2/extra/httpd-multilang-errordoc.conf

# 動態(tài)目錄列表形式配置
Include /private/etc/apache2/extra/httpd-autoindex.conf

# 語言設(shè)置
#Include /private/etc/apache2/extra/httpd-languages.conf

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

# 關(guān)于請求和配置的實(shí)時(shí)信息
#Include /private/etc/apache2/extra/httpd-info.conf

# 虛擬主機(jī)
Include /private/etc/apache2/extra/httpd-vhosts.conf

# 本地訪問 Apache HTTP 服務(wù)器指南
#Include /private/etc/apache2/extra/httpd-manual.conf

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

# 各種默認(rèn)設(shè)置
#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一個靜態(tài)的內(nèi)編譯.
#
<IfModule ssl_module>
SSLRandomSeed startup builtin
SSLRandomSeed connect builtin
</IfModule>

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

#
# 取消以下注釋處理用戶代理故意違反使用 DNT 開放標(biāo)準(zhǔn)(DNT必須是一個特定的最終用戶的選擇) 
#
#<IfModule setenvif_module>
#BrowserMatch "MSIE 10.0;" bad_DNT
#</IfModule>
#<IfModule headers_module>
#RequestHeader unset DNT env=bad_DNT
#</IfModule>