- 相關推薦
如何正確發布PHP代碼
幾乎每一個 PHP 程序員都發布過代碼,可能是通過 ftp 或者 rsync 同步的,也可能是通過 svn 或者 git 更新的。一個活躍的項目可能每天都要發布若干次代碼,但是現實卻是很少有人注意其中的細節,實際上這里面有好多坑,很可能你就在坑中卻渾然不知。下面是小編為大家帶來的關于如何正確發布PHP代碼的知識,歡迎閱讀。
如何正確發布PHP代碼
一個正確實現的發布系統至少應該支持原子發布。如果說每一個版本都表示一個獨立的狀態的話,那么在發布期間,任何一次請求只能在單一狀態下被執行。 如此稱之為支持原子發布;反之如果在發布期間,一次請求跨越不同的狀態,那么就不能稱之為原子發布。我們不妨舉個例子來說明一下:假設一次請求需要 include 兩個 PHP 文件,分別是 a.php 和 b.php,當 include a.php 完成后,發布代碼,接著 include b.php,如果處理不當的話,那么就可能會導致舊版本的 a.php 和新版本的 b.php 同時存在于同一個請求之中,換句話說就是沒有實現原子發布。
開源世界里有很多不錯的發布代碼工具,比如 ruby 社區的 capistrano,其流程大致就是發布代碼到一個全新的目錄,然后再軟鏈接到真正的發布目錄。
.
├── current -> releases/v1
└── releases
├── v1
│ ├── foo.php
│ └── bar.php
└── v2
├── foo.php
└── bar.php
不過鑒于 PHP 本身的特殊性,如果只是簡單套用上面的流程,那么將很難實現真正的原子發布。要理清個中緣由,還需要了解一下 PHP 中的兩個 Cache 的概念:
opcode cache
realpath cache
先聊聊 opcode cache,基本就是 apc 或者 zend opcode,關于它的作用,大家都已經很熟悉,不必多言,需要注意的是 apc 的 bug 很多,比如開啟了 apc.enable_cli 配置后就會有很多靈異問題,所以說 opcode cache 還是盡可能使用 zend opcache 吧,如果需要緩存數據,可以用 apcu。此外 apc 和 zend opcode 對緩存鍵的選擇有所差異:apc 選擇的是文件的 inode,zend opcode 選擇的是文件的 path。
再聊聊 realpath cache,它的作用是緩沖獲取文件信息的 IO 操作,大多數時候它對我們而言是透明的,以至于很多人都不知道它的存在,需要注意的是 realpath cache 是進程級別的,也就是說,每一個 php-fpm 進程都有自己獨立的 realpath cache。
假設在發布代碼期間,opcode cache 或者 realpath cache 里的數據出現過期,那么就會出現一部分緩存是舊文件,一部分緩存是新文件的非原子發布的情況,為了避免出現這種情況,我們應該保證緩存過期時間足夠長,最 好是除非我們手動刷新,否則永遠不過期,對應到配置上就是:關閉 apc.stat、opcache.validate_timestamps 配置,設置足夠大的 realpath_cache_size、realpath_cache_ttl 配置,必要的監控總是有好處的。
相關的技術細節特別瑣碎,建議大家仔細閱讀如下資料:
realpath_cache
PHP’s OPCache extension review
Atomic deploys at Etsy
Cache invalidation for scripts in symlinked folders
在采用軟鏈接發布代碼的時候,通常遇到的第一個問題多半是新代碼不生效!即便調用了 apc_clear_cache 或者 opcache_reset 方法也無效,重啟 php-fpm 自然是能夠解決問題,不過對腳本語言來說重啟太重了!難道除了重啟就沒有別的.辦法了么?
BTW:如果需要手動重置 opcode cache,需要注意的是因為它是基于 SAPI 的概念,所以不能直接在命令行下調用 apc_clear_cache 或者 opcache_reset 方法來重置緩存,當然辦法總是有的,那就是使用 CacheTool 在命令行下模擬 fastcgi 請求。
事實上之所以會出現這樣的問題,主要是因為 opcode cache 是通過 realpath cache 獲取文件信息,即便軟鏈接已經指向了新位置,但是如果 realpath cache 里還保存著舊數據的話,opcode cache 依然無法知道新代碼的存在,缺省情況下,realpath_cache_ttl 緩存有效期是兩分鐘,這意味著發布代碼后,可能要兩分鐘才能生效。為了讓發布盡快生效,需要以進程為單位清除 realpath cache:
<?php
$key = 'php.pid_' . getmypid();
if (($rev = apc_fetch($key)) != DEPLOY_VERSION) {
if($rev < DEPLOY_VERSION) {
apc_store($key, DEPLOY_VERSION);
}
clearstatcache(true);
}
?>
如此在 apc 環境下基本就能工作了,但是在 zend opcode 環境下還可能有問題。因為在缺省情況下 opcache.revalidate_path 是關閉的,此時會緩存符號鏈接的值,這會導致即便軟鏈接指向修改了,也永遠無法生效,所以在使用 zend opcode 的時候,如果使用了軟鏈接,視情況可能需要把 opcache.revalidate_path 激活。
分析到這里,我們不妨反思一下:在 PHP 中原子發布之所以是一個棘手的問題,歸根結底是因為軟鏈接和緩存之間的的矛盾。不管是 opcode cache 還是 realpath cache,都是 PHP 固有的緩存特性,基于客觀需要無法繞開,如此說來是否有辦法繞開軟鏈接,使其成為馬奇諾防線呢?答案是 nginx 的 $realpath_root:
fastcgi_param SCRIPT_FILENAME $realpath_root $fastcgi_script_name;
fastcgi_param DOCUMENT_ROOT $realpath_root;
有了 $realpath_root,即便 DOCUMENT_ROOT 目錄中含有軟鏈接,nginx 也會把軟鏈接指向的真正的路徑發給 PHP,也就是說,對 PHP 而言,軟鏈接已經不存在了!不過作為代價,每一次請求,nginx 都要通過相對昂貴的 IO 操作獲取 $realpath_root 的值,通過 strace 命令我們能監控這一過程,下圖從 current 到 foo 的過程:
realpath
在本例中,壓測發現使用 $realpath_root 后,性能下降了大約 5% 左右,不過明眼人一下就能發現,雖然 $realpath_root 導致了 lstat 和 readlink 操作,但是 lstat 操作的次數是和目錄深度成正比的,也就是說目錄越深,執行的 lstat 次數越多,性能下降也就越大。如果能夠降低發布目錄的深度,那么可以預計性能下降能夠控制在 1% 左右。
結尾介紹一下 Deployer,它是 PHP 中做得比較好的工具,有很多特色,比如支持并行發布,具體演示如下圖,左邊是串行,右邊是并行,使用「vvv」能得到更詳細信息:
deploy
不過 Deployer 在原子發布上有一點瑕疵,具體見 deploy:release 代碼:
<?php
run("cd {{deploy_path}} && if [ -h release ]; then rm release; fi");
run("ln -s $releasePath {{deploy_path}}/release");
?>
也就是說,在切換軟鏈接的時候,它是先刪除再創建,是一個兩步操作,理論上如果有請求在這兩步中間進入的話,那么將會出現找不到文件的錯誤。
問題到這里,大部分人會覺得使用「ln -sfn」就好了,實際上也是錯誤的:
shell> strace ln -sfn releases/foo current
symlink("releases/foo", "current") = -1 EEXIST (File exists)
unlink("current") = 0
symlink("releases/foo", "current") = 0
通過 strace 我們能清晰的看到,雖然表面上使用「ln -sfn」是一步操作,但是內部依然是按照先刪除再創建的邏輯執行的,實際上這里應該搭配使用「ln & mv」:
shell> ln -sfn releases/foo current.tmp
shell> mv -fT current.tmp current
先通過 ln 創建一個臨時的軟鏈接,再通過 mv 實現原子操作,此時如果使用 strace 監控,會發現 mv 的「T」選項實際上僅僅執行了一個 rename 操作,所以是原子的。
據說一千個人的心中就有一千個哈姆雷特,不過我希望所有的 PHP 程序員在發布 PHP 代碼的時候都能采用一種方法,那就是本文介紹的方法,正確的方法。
【如何正確發布PHP代碼】相關文章:
PHP代碼如何規范02-13
PHP如何編寫易讀的代碼06-02
如何閱讀php源代碼02-19
如何寫出優雅的PHP代碼07-24
PHP中如何實現crontab代碼05-30
如何在cmd下面寫php代碼06-21
如何在HTML中嵌入PHP代碼03-18
如何正確配置 Nginx + PHP03-01
php代碼如何實現命令行執行05-19