Because strict is reserved to be joke, I accidentally found this easter egg in php-src 1 some day.

WTF...XD

$ php -r 'use strict;'
PHP Fatal error:  You seem to be trying to use a different language... in Command line code on line 1

PHP 的吉祥物是大象，這個大家都不陌生，但是如果看到一隻飛奔的大象，那你可能會揉揉眼睛質疑自已是否眼花。

事實上這是 PHP 官方所埋藏的彩蛋，因為有人運氣好無意間看到，但不太領情，反而覺得不舒服，所以跑到 PHP mailing list 抱怨 1 才被挖掘出來...

除此之外，在 https://php.net 任意網頁下直接鍵入 logo 然後按 enter 後，還有很多復古的 logo 等著大家去發現，可以參閱 Github 上的程式碼 logo.php 2 和 common.js 3。

今天在聽 小鐵 講 DI 實作 1 時提到了這個例子，當下在想如果換成 PHP 5.6 的 arguments unpack 的語法不曉得會不會動，驗證完後覺得很有趣，順便來寫一篇。

不像 Java，PHP 在執行期時才決定要產生哪個類別的 instance 或呼叫哪個函式，並不需要大費周章的用 Reflection API，但還是有些是不透過 Reflection 辦不到的事，其中產生 instance 時如果要傳入參數的話，就需要透過 ReflectionClass 來達成這個目的。

前面提到的問題，你沒辦法用 call_user_func 或 call_user_func_array 來達成目的，因為沒辦法滿足第一個 callable 參數...

1. 建構子不是 static method，你沒辦法用 Foo::__construct 這種方式，如果可以的話，參數的傳遞是另外一個問題。

2. 在執行建構子時你需要傳入 instance，你都要靠它產生 instance 了，它還跟你討 instance，這兩個條件互斥了，變成雞生蛋與蛋生雞的問題，所以沒辦法用 array($instance, '__construct')。

PoC 的程式碼如下，跑一下 benchmark

<?php
// bench.php
function bench($callback)
{
    $start = microtime(true);
    $callback();
    return (microtime(true) - $start);
}

class Foo
{
    public function __construct($a, $b, $c)
    {
        // var_dump(func_get_args());
    }
}

$class_name = 'Foo';
$loop = 5000000;

$elapsed_time = bench(
    function() use ($class_name, $loop) {
        global $argv;

        $i = 0;
        while ($i++ < $loop) {
            $ref_class = new ReflectionClass($class_name);
            $instance = $ref_class->newInstanceArgs($argv);
        }
    }
);
echo "Reflection take $elapsed_time seconds\n";

$elapsed_time = bench(
    function() use ($class_name, $loop) {
        global $argv;

        $i = 0;
        while ($i++ < $loop) {
            $instance = new $class_name(...$argv);
        }
    }
);
echo "Arguments unpack take $elapsed_time seconds\n";

輸出如下，可以看出效率快一點點，另外的優點是拿 splat operator ... 來換兩行 ReflectionClass 的寫法變的簡潔有力！

shell> time ~/.phpbrew/php/php-5.6.0RC4/bin/php bench.php foo bar
Reflection take 8.2250480651855 seconds
Arguments unpack take 2.4252769947052 seconds

real    0m10.669s
user    0m10.656s
sys     0m0.008s

提外話：

在過程中還發生另外的小插曲，在利用 phpbrew build 5.6.0RC4 來測試上面的 PoC，發現在 build unstable 的版本時動不了，動手修正後送 pull request 2 回去，不久後收到 comment 的回覆的信件時，順便被告知 PHP 5.6.0 GA 了！！也太巧了吧...XD

GitHub 作為地表上最受歡迎原始碼代管平台 1，自然而然就會有工具利用它形成一個分享的生態圈，Vundle 及 Homebrew 就是經典的例子。

用 Vundle 安裝 vim plugin 時，只要簡單像下面加上一行 Plugin directive。

" .vimrc
Plugin "user/repo"

在 :PluginInstall 時就會去 GitHub 把 user/repo clone 在 .vim/bundle/user-repo 裡，再利用修改 vim runtimepath 的方法達到載入 plugin 的目的。

今天要介紹的 Homebrew Tap 2 也是利用 GitHub 來新增額外的 repo，用來分類與管理 formulae。

舉我剛剛建立的 Gasol/homebrew-formulae 為例：

首先在 GitHub 上建立好 repository，這邊要注意的是 repo 的名字一定要有 homebrew- 的前綴 3，否則 brew tap 會找不到。

shell> brew tap gasol/formulae

brew tap 會把 repo clone 在 /usr/local/Library/Taps/gasol/homebrew-formulae

shell> tree -CL 2 /usr/local/Library/Taps/
/usr/local/Library/Taps/
├── caskroom
│   └── homebrew-cask
├── gasol
│   └── homebrew-formulae
└── homebrew
├── homebrew-completions
├── homebrew-dupes
├── homebrew-php
└── homebrew-science

為了要 push formulae 上去 remote，所以我們要把 git 的 url 從 https 換成 ssh 的版本。

shell> cd /usr/local/Library/Taps/gasol/homebrew-formulae
shell /usr/local/Library/Taps/gasol/homebrew-formulae> git remote show origin
* remote origin
  Fetch URL: https://github.com/Gasol/homebrew-formulae.git
  Push  URL: https://github.com/Gasol/homebrew-formulae.git
  HEAD branch: master
  Remote branch:
    master tracked
  Local branch configured for 'git pull':
    master merges with remote master
  Local ref configured for 'git push':
    master pushes to master (up to date)

shell /usr/local/Library/Taps/gasol/homebrew-formulae> git remote set-url origin git@github.com:Gasol/homebrew-formulae.git
shell /usr/local/Library/Taps/gasol/homebrew-formulae> git remote show origin
* remote origin
  Fetch URL: git@github.com:Gasol/homebrew-formulae.git
  Push  URL: git@github.com:Gasol/homebrew-formulae.git
  HEAD branch: master
  Remote branch:
    master tracked
  Local branch configured for 'git pull':
    master merges with remote master
  Local ref configured for 'git push':
    master pushes to master (up to date)

之後就可以把自已建立的 formulae commit 進 repo 後再 push 上 GitHub。

shell /usr/local/Library/Taps/gasol/homebrew-formulae> git push -u origin master
Counting objects: 3, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 485 bytes | 0 bytes/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To git@github.com:Gasol/homebrew-formulae.git
 * [new branch]      master -> master
Branch master set up to track remote branch master from origin.

舉凡官方不收或是有 license 疑慮的 formulae 變可透過 Homebrew Tap 的方式來自已管理。

相對於其他語言，PHP 對於曾經寫過 C 的人來說比較容易上手，其中一個原因是 PHP 與 Standard C Library (libc) 有眾多函式名稱是一樣的，我相信 PHP 是刻意如此，有些函式連參數也一樣，只存在強弱型別的差異而已，檔案操作一系列的函式 fopen、fread、fwrite、fclose、feof、fgets、fgetc、ftell、fseek...等等就是較經典的例子。

其中 feof 就是今天的主角，使用上有一些眉角要注意，feof 通常拿來確認有沒有完整讀取到檔尾，所以在 PHP 中如果要從 stdin 一行一行的讀出來做資料處理的話可以寫成下面這樣：

<?php
// feof.php
while (!feof(STDIN)) {
    $line = fgets(STDIN);
    var_dump($line);
}

執行結果輸出如下，你會發現多出了 false 這個預期外的結果...

shell> echo -e "1\n2\n3" | php feof.php
string(2) "1
"
string(2) "2
"
string(2) "3
"
bool(false)

原因是 feof 是被動方式確認 flag 是否包含 EOF，所以要有另外一個角色要主動來設 EOF flag，這個主動的方式就是透過讀取的行為觸發，這點在 C 裡行為也是一樣的，所以安全起見可以多加一行判斷改寫成這樣，多出來的那一行 false 就不見了。

<?php
// feof.php
while (!feof(STDIN)) {
    $line = fgets(STDIN);
    if (feof(STDIN)) {
        break;
    }
    var_dump($line);
}

上面會動，但是不夠，因為太醜了，fgets 回傳 false 代表兩個意思，一是沒有資料可以讀取，二是有錯誤產生，利用這個特性再改寫如下：

<?php
// feof.php
while (!feof(STDIN)) {
    $line = fgets(STDIN);
    if (false === $line) {
        break; // continue is bad.
    }
    var_dump($line);
}

上述程式碼變數 $line 遇到 false 後 break 跳出迴圈，如果 false 是代表一的狀況的話算是瞎貓碰上死耗子，如果是第二種狀況，那就有讀取不完整的問題。如果把 break 用 continue 取代，意味著 fgets 遇到錯誤重新嘗試 (retry)，判斷檔案結束由 feof 把關，這樣同時解決了兩個的問題，但是如果碰上 fgets 一直失敗這種 edge case 就會造成無窮迴圈的產生，應該要儘量避免...

下面的版本充份利用 fgets 及 feof 的特性：

<?php
// feof.php
while (true) {
    $line = fgets(STDIN);
    if (false === $line) {
        break;
    }
    var_dump($line);
}

if (!feof(STDIN)) {
    trigger_error("Failed to read", E_USER_WARNING);
}

大量的讀檔可以稍微快一點的版本，犧牲一點可讀性換來一點效率...

<?php
// feof.php
while (false !== ($line = fgets(STDIN))) {
    var_dump($line);
}

if (!feof(STDIN)) {
    trigger_error("Failed to read", E_USER_WARNING);
}

到這邊還沒結束，feof 參數是 stream resource，如果參數不對會有 warning 警告，但回傳值是 false，這很容易造成無窮迴圈，所以如果你沒有檢查回傳值是否正確的好習慣，預期 fopen 開檔都會成功回傳 file pointer，沒有檢查 fopen 開檔失敗，就很容易踩中這個地雷。

<?php
// infinite loop demonstration
$fp = fopen('/file/not_exist', 'r');
while (!feof($fp)) {
    var_dump($line);
}

另外 feof 拿來處理 fsockopen 或是 fopen HTTP 的 url 回傳的 stream 也很危險，官網上 workaround 1 的方法只能說醜到爆炸，所以如果有 HTTP 的操作請儘量用高階一點的 API 來取代。

以前沒有特別注意到的功能，Aaron 說 tmux 更新成 1.9 就不會動了，官方 FAQ - How can I open a new window in the same directory as the current window? 提供了一個方法，但是設上去了也沒有效。

官方的方法 TMUXPWD_$(tmux display -p "#I") 是把當下的工作目錄存在環境變數，#I 為 Index of Window，然後 bind 一組按鍵來執行 tmux new-window 指令，可以簡寫成 neww，該指令後面可以帶 shell-command，如此，就可以在開新視窗時切換到預先存在環境變數的工作目錄。

這個麻煩的方法不能動的原因在於 $PWD 的 precedence，其實可以用 PROMPT_COMMAND 來修正，不過緊接著提供的方法更簡潔。

PROMPT_COMMAND=$([ -n "$TMUX" ] && tmux setenv TMUXPWD_$(tmux display -p "#I") $PWD)

tmux 1.9 之前是照著下面這個 commit 的說明運作，default-path 設定來決定另開新窗的預設工作目錄，如果沒有設定，預設就是繼承上一個視窗的工作目錄。

c1b994852594b23b7443e01e05257c991684ba4e -p
commit c1b994852594b23b7443e01e05257c991684ba4e
Author: Nicholas Marriott <nicholas.marriott@gmail.com>
Date:   Fri Dec 9 16:37:29 2011 +0000

    Change the way the working directory for new processes is discovered. If
    default-path isn't empty, it is used. Otherwise:

    1) If tmux neww is run from the command line, the working directory of the
    client is used.

    2) Otherwise use some platform specific code to retrieve the current working
    directory of the process in the active pane.

    3) If that fails, the directory where the session was created is used.

    Idea and support code, Linux, Solaris, FreeBSD bits by Romain Francoise,
    OpenBSD bits by me.

不過 default-path 在 1.9 時被移除了，見下面 commit，取而帶之是用 -c 的參數來決定 new、neww、splitw 開新視窗時的工作目錄。

commit 4538c269d0b366a770a5a5ebfe0c5007569edbc1
Author: Nicholas Marriott <nicholas.marriott@gmail.com>
Date:   Sun Oct 6 21:02:23 2013 +0100

    Alter how tmux handles the working directory to internally use file descriptors
    rather than strings.

    - Each session still has a current working directory.

    - New sessions still get their working directory from the client that created
      them or its attached session if any.

    - New windows are created by default in the session working directory.

    - The -c flag to new, neww, splitw allows the working directory to be
      overridden.

    - The -c flag to attach let's the session working directory be changed.

    - The default-path option has been removed.

    To get the equivalent to default-path '.', do:

            bind c neww -c $PWD

    To get the equivalent of default-path '', do:

            bind c neww -c '#{pane_current_path}'

    The equivalent of default-path '~' is left as an exercise for the reader.

    This also changes the client identify protocol to be a set of messages rather
    than one as well as some other changes that should make it easier to make
    backwards-compatible protocol changes in future.

最後我們把 escape + CTRL-c 的組合鍵定義成開新視窗時保留當下的工作目錄的動作。

// .tmux.conf
bind-key C-c new-window -c '#{pane_current_path}'

有沒有注意到些什麼？ tmux commit message 寫的好漂亮...

Happy ending.

下圖是家裡的流量圖，零晨到二點半那段是在看 Google IO 直播產生的流量，挺有趣的...:)，不過 In/Out 相反了，後面有談到解決方法。

小烏龜就是申請中華電信網路服務時所配發的 vdsl modem，我拿到的型號是 ZyXEL P874，有簡易的 Web 介面可以透過瀏覽器設定，即時在遠端也可以透過 telnet 來作業。

$ telnet 192.168.1.1
Trying 192.168.1.1...
Connected to 192.168.1.1.
Escape character is '^]'.
ZyXEL VDSL Router
Login: cht
Password: <google>

   Main Menu

 1. VDSL Link State
 2. LAN/WLAN
 3. WAN
 4. DNS Server
 5. Route Setup
 6. NAT
 7. Firewall
 8. Quality Of Service
 9. Management
10. Passwords
11. Reset to Default
12. Reboot
13. Exit
 > 9
 
   SNMP Agent Menu

 1. Configure
 2. Show
 3. Exit
/Management/SNMP Agent > 2

        SNMP Agent Information

State                : enable
Read only community  : chtnvdsl
Read write community : xdsl
System name          : CHT
System location      : unknown
System contact       : unknown
Trap IP address      : 0.0.0.0

Hit <enter> to continue

預設 SNMP 是開啟的，可以看到 Read only cummunity 的值是 chtnvdsl (咦！怎麼有點眼熟...XD)，接著用 snmpwalk 來看一下總共有哪些 OID。

$ snmpwalk -c chtnvdsl 192.168.1.1
IF-MIB::ifNumber.0 = INTEGER: 14
IF-MIB::ifIndex.1 = INTEGER: 1
IF-MIB::ifIndex.2 = INTEGER: 2
IF-MIB::ifIndex.3 = INTEGER: 3
IF-MIB::ifIndex.4 = INTEGER: 4
IF-MIB::ifIndex.5 = INTEGER: 5
IF-MIB::ifIndex.6 = INTEGER: 6
IF-MIB::ifIndex.7 = INTEGER: 7
IF-MIB::ifIndex.8 = INTEGER: 8
IF-MIB::ifIndex.9 = INTEGER: 9
IF-MIB::ifIndex.10 = INTEGER: 10
IF-MIB::ifIndex.11 = INTEGER: 11
IF-MIB::ifIndex.12 = INTEGER: 12
IF-MIB::ifIndex.13 = INTEGER: 13
IF-MIB::ifIndex.14 = INTEGER: 14
IF-MIB::ifDescr.1 = STRING: eth0
IF-MIB::ifDescr.2 = STRING: eth1
IF-MIB::ifDescr.3 = STRING: eth2
IF-MIB::ifDescr.4 = STRING: eth3
IF-MIB::ifDescr.5 = STRING: wl0
IF-MIB::ifDescr.6 = STRING: wl0.1
IF-MIB::ifDescr.7 = STRING: wl0.2
IF-MIB::ifDescr.8 = STRING: wl0.3
IF-MIB::ifDescr.9 = STRING: ptm0
IF-MIB::ifDescr.10 = STRING: ptm0_1
IF-MIB::ifDescr.11 = STRING: ptm0_2
IF-MIB::ifDescr.12 = STRING: ptm0_4
IF-MIB::ifDescr.13 = STRING: ppp0_3
IF-MIB::ifDescr.14 = STRING: dsl0
... skip

確認完後就用 cfgmaker 產生設定檔樣版。

$ cfgmaker --output=mrtg.cfg chtnvdsl@192.168.1.1

接著修改設定，沒有 ifSpeed 的值和 ifOperStatus 為 down 時設定會是註解起來的，然後介面 ppp0_3 的 In/Out 是相反的，參考 MRTG Reference - Reversing 1，把 Target 的值多個負號 (-) 就可以了

範例

Target[ezci]: -1:public@ezci-ether.domain

接著用 mrtg 透過 RRDTool 來生流量圖，這個指令要定時跑才能定時更新流量圖，所以要把這個指令加入 cron 每五分鐘值行一次，Mac 可以透過 launchd 來排程。

$ env LANG=C mrtg /etc/mrtg.cfg

用 indexmaker 產生 HTML 並擺在 Web 存取的到的地方，這邊只要執行一次，要注意輸出的目錄權限能不能寫入。

$ indexmaker --output=/path/to/htdocs/mrtg/index.html --title=Home mrtg.cfg

這樣就完成了，等個 24 小時應該就有些數據可以看了。

在做之前其實有 survey 了其他的方案，比較過後最後還是覺得用 MRTG 簡單畫就好了，相依性少一點，如果要偵測異常流量的話只要定個 threshold，然後簡單寫個 shell script 排程跑寄信通知就好了。

活著 (active) 的專案隨著時間過去只會愈長愈大，豬養肥了就是要殺? 不管理由如何，總是有重整的機會。一般的情況下，目錄結構都是有組織的，也就是同性質的 resource 會擺放在一起，所以大部份的 case 都是拆單一目錄出來為獨立的 git repository。

依目錄拆 repository，換句話說就是把該目錄的 commit 全部保留，其餘的不要，當你建出這一個分支時，剩下的就只是合併剩下的成果而已，只要掌握這個概念的話，下面的操作就不難理解。

一開始我的土炮做法，以 laravel/framework 1 為例子，把 illuminate/database 拆出來。

首先做不做備份取決於你的信心，因為 remote 那有一份了，所以我自已都沒有做。
你可以另外 clone 一份 repository 下來，也可以另外開 branch 出來操作。

$ git clone git@github.com:laravel/framework.git

開一個 database branch 來操作

$ cd framework
framework (master) $ git checkout -b database
framework (database) $ 

利用 git filter-branch 來改寫歷史

framework (database) $ git filter-branch --subdirectory-filter src/Illuminate/Database/ database
Rewrite adbb29172a4a70972c15e9564649dd4b520fcf66 (1059/1059)
Ref 'refs/heads/database' was rewritten

結束後可以看到 src/Illuminate/Database 目錄下的檔案都攤在根目錄了

framework (database) $ ls -l
total 136
drwxrwxr-x 10 gasolwu gasolwu  4096  6月 17 01:35 ./
drwxrwxr-x 10 gasolwu gasolwu  4096  6月 17 01:28 ../
drwxrwxr-x  2 gasolwu gasolwu  4096  6月 17 01:35 Capsule/
-rwxrwxr-x  1 gasolwu gasolwu   889  6月 17 01:35 composer.json*
-rwxrwxr-x  1 gasolwu gasolwu  2895  6月 17 01:35 ConnectionInterface.php*
-rwxrwxr-x  1 gasolwu gasolwu 20643  6月 17 01:35 Connection.php*
-rwxrwxr-x  1 gasolwu gasolwu   502  6月 17 01:35 ConnectionResolverInterface.php*
-rwxrwxr-x  1 gasolwu gasolwu  1615  6月 17 01:35 ConnectionResolver.php*
drwxrwxr-x  2 gasolwu gasolwu  4096  6月 17 01:35 Connectors/
drwxrwxr-x  3 gasolwu gasolwu  4096  6月 17 01:35 Console/
-rwxrwxr-x  1 gasolwu gasolwu  6141  6月 17 01:35 DatabaseManager.php*
-rwxrwxr-x  1 gasolwu gasolwu  1267  6月 17 01:35 DatabaseServiceProvider.php*
drwxrwxr-x  3 gasolwu gasolwu  4096  6月 17 01:35 Eloquent/
drwxrwxr-x  8 gasolwu gasolwu  4096  6月 17 01:35 .git/
-rwxrwxr-x  1 gasolwu gasolwu  3611  6月 17 01:35 Grammar.php*
drwxrwxr-x  3 gasolwu gasolwu  4096  6月 17 01:35 Migrations/
-rwxrwxr-x  1 gasolwu gasolwu  5537  6月 17 01:35 MigrationServiceProvider.php*
-rwxrwxr-x  1 gasolwu gasolwu  1444  6月 17 01:35 MySqlConnection.php*
-rwxrwxr-x  1 gasolwu gasolwu  1194  6月 17 01:35 PostgresConnection.php*
drwxrwxr-x  4 gasolwu gasolwu  4096  6月 17 01:35 Query/
-rw-rw-r--  1 gasolwu gasolwu  1340  6月 17 01:35 QueryException.php
-rwxrwxr-x  1 gasolwu gasolwu  2198  6月 17 01:35 README.md*
drwxrwxr-x  3 gasolwu gasolwu  4096  6月 17 01:35 Schema/
-rwxrwxr-x  1 gasolwu gasolwu  1661  6月 17 01:35 Seeder.php*
-rwxrwxr-x  1 gasolwu gasolwu   975  6月 17 01:35 SeedServiceProvider.php*
-rwxrwxr-x  1 gasolwu gasolwu  1133  6月 17 01:35 SQLiteConnection.php*
-rwxrwxr-x  1 gasolwu gasolwu  2122  6月 17 01:35 SqlServerConnection.php*

這時後也可以用 tig 或 git log 看一下 history 長什麼樣子。

framework (database) $ git log -m -stat -n 1
commit 291c2e9139086aefefb3db32e56675c67d92c1ec (from ec71e594c245eeb5c05d6de7a770399e045341a4)
Merge: ec71e59 74b8089
Author: Taylor Otwell <taylorotwell@gmail.com>
Date:   Fri Jun 13 15:12:36 2014 -0500

    Merge branch '4.2'

 Console/Migrations/RefreshCommand.php | 10 ++++++++--
 Schema/Blueprint.php                  | 10 ++++++++++
 2 files changed, 18 insertions(+), 2 deletions(-)

commit 291c2e9139086aefefb3db32e56675c67d92c1ec (from 74b8089b6ff5aed2129cbd7e7559144b68d3f660)
Merge: ec71e59 74b8089
Author: Taylor Otwell <taylorotwell@gmail.com>
Date:   Fri Jun 13 15:12:36 2014 -0500

    Merge branch '4.2'

 Query/Builder.php | 46 ++++++++++++++++++++++++++++++++++++++++++++--
 composer.json     | 23 +++++++++++------------
 2 files changed, 55 insertions(+), 14 deletions(-)
 
commit 74b8089b6ff5aed2129cbd7e7559144b68d3f660
Author: Taylor Otwell <taylorotwell@gmail.com>
Date:   Fri Jun 13 14:28:23 2014 -0500

    Working on documentation block.

 Schema/Blueprint.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

如果不想攤在根目錄，而是放在 src 目錄的話，要再多做一步 filter-branch，--tree-filter 後面接的是 command 會被 shell 執行 (透過 eval)，所以這邊我們建立 src/ 目錄 （replay 當下可能不存在)，然後判斷根目錄的每個檔案如果不是一開始建立的 src/ 目錄，就把它搬到 src/ 裡去

framework (database) $ git filter-branch -f --tree-filter 'mkdir -p src; for d in *; do if [ $d != "src" ]; then mv $d src/; fi; done;' database
Rewrite 291c2e9139086aefefb3db32e56675c67d92c1ec (1059/1059)
Ref 'refs/heads/database' was rewritten

結果就變這樣

framework (database) $ tree -d
.
└── src
    ├── Capsule
    ├── Connectors
    ├── Console
    │   └── Migrations
    ├── Eloquent
    │   └── Relations
    ├── Migrations
    │   └── stubs
    ├── Query
    │   ├── Grammars
    │   └── Processors
    └── Schema
        └── Grammars

14 directories

最後，因為歷史被改寫的關係，master 與 database branch 除了 commit 訊息相似之外，已經是兩條平行的 tree 了，只要簡單 init 一個 git repository，並把創造出來的 database branch fetch 回來，然後 merge 就結束了 (等同於 git pull 的操作)。

$ cd /path/to/new_repo
new_repo $ git init
Initialized empty Git repository in /path/to/new_repo/.git/
new_repo (master) $ git fetch /path/to/framework database
remote: Counting objects: 5889, done.
remote: Compressing objects: 100% (1821/1821), done.
remote: Total 5889 (delta 3026), reused 3762 (delta 3007)
Receiving objects: 100% (5889/5889), 1.54 MiB | 0 bytes/s, done.
Resolving deltas: 100% (3026/3026), done.
From ../framework
 * branch            database   -> FETCH_HEAD
 
new_repo (master) $ git merge FETCH_HEAD

想像一下，補上 composer.json 和 autoload PSR-4 後，是不是就像是一個獨立的 composer package，建議可以用這個方式拆 module，module 一多就可以利用 composer 的 replace 來組 full stack 的 package，有點像是 Debian dummy package 或 FreeBSD meta port 的概念，拆細的彈性就在這裡。

另外補充一下其他作法，--subdirectory-filter 那邊可以用 git subtree，上面兩段 filter-branch 可以用下面一行來完成...

framework (database) $ git filter-branch --subdirectory-filter src/Illuminate/Database/ --index-filter 'git ls-files -s | sed "s|\t\"*|&src/|" | GIT_INDEX_FILE=$GIT_INDEX_FILE.new git update-index --index-info && mv $GIT_INDEX_FILE.new $GIT_INDEX_FILE' database

指令有點長，不過這一段有寫在 manpage 的範例裡，所以不用刻意去背它。

自已曾經碰過，今天被問到的問題，覺得解釋的不太好，所以事後把它寫下來。

問題是這樣子：

某個 class 裡面的 method 呼叫一段在其他檔案定義的 function，回傳值卻不如預期。

實際把問題簡化成 sample code 如下：

假設 app.php 與 lib.php 都在同一層目錄

lib.php

<?php

$exchange_rates = array(
    'TW' => 30,
);

function currency_convert($currency, $to)
{
    global $exchange_rates;
    return $currency * $exchange_rates[$to];
}

app.php

<?php

require __DIR__ . '/lib.php';

echo currency_convert(10, 'TW') . PHP_EOL;

這邊為了簡單呈現問題，不做 sanity check，上面這一段輸出預期會是 300，但是在特地的條件下 currency_convert() 的回傳的會是讓你驚訝的 0，我們把 app.php 修改為下面的內容：

<?php

call_user_func(function() {
    require __DIR__ . '/lib.php';
});

echo currency_convert(10) . PHP_EOL;

這邊簡單用 anonymous function 來 require lib.php 來重製問題，故意讓 currency_convert() 壞掉，結果輸出就會是 0，知道問題了嗎？

與 C 一樣，PHP 在 function 裡的變數都是區域變數，唯一不同的地方在全域變數在 PHP function 裡必需要用 global 宣告才能看的到。

所以在上面的例子中， $exchange_rates 因為 anonymous function 的關係，他從全域變數變成了區域變域，只在 anonymous function 裡才存取的到。

千萬別認為神經病才用 anonymous function 來 require library！市面上所見到 autoload 機制的 class loader 1，大多都是在 method (或 function) 裡來 require 檔案，然後就引爆地雷了。

workaround 的方法就是在看的到變數的地方做手腳，所以有幾種方法：

1. 在 require 前宣告 global $var
2. 用 superglobal 變數 $GLOBALS
3. 你有權限 touch 的到 lib.php 的話，在外面的 $exchange_rate 也可以宣告成 global，global 並沒有限制一定要在 function 裡使用，在 function 外也可以使用，因為檔案在 function 裡被引用的話，此時的 global 就發揮用處了

後話

有一定年紀的 PHP Application，如果持續維護至今的話，應該都會面臨 programming paradigm 從 precedural 轉換至 object-oriented 的過程，在轉換過程之中就很容易遇到這類的問題。

這個問題是義大利麵與定食共享的結果。

You're live! Nice. We've put together a little post to introduce you to the Ghost editor and get you started. You can manage your content by signing in to the admin area at <your blog URL>/ghost/. When you arrive, you can select this post from a list on the left and see a preview of it on the right. Click the little pencil icon at the top of the preview to edit this post and read the next section!

Getting Started

Ghost uses something called Markdown for writing. Essentially, it's a shorthand way to manage your post formatting as you write!

Writing in Markdown is really easy. In the left hand panel of Ghost, you simply write as you normally would. Where appropriate, you can use shortcuts to style your content. For example, a list:

• Item number one
• Item number two
  • A nested item
• A final item

or with numbers!

1. Remember to buy some milk
2. Drink the milk
3. Tweet that I remembered to buy the milk, and drank it

Links

Want to link to a source? No problem. If you paste in url, like http://ghost.org - it'll automatically be linked up. But if you want to customise your anchor text, you can do that too! Here's a link to the Ghost website. Neat.

What about Images?

Images work too! Already know the URL of the image you want to include in your article? Simply paste it in like this to make it show up:

Not sure which image you want to use yet? That's ok too. Leave yourself a descriptive placeholder and keep writing. Come back later and drag and drop the image in to upload:

![A bowl of bananas]

Quoting

Sometimes a link isn't enough, you want to quote someone on what they've said. It was probably very wisdomous. Is wisdomous a word? Find out in a future release when we introduce spellcheck! For now - it's definitely a word.

Wisdomous - it's definitely a word.

Working with Code

Got a streak of geek? We've got you covered there, too. You can write inline <code> blocks really easily with back ticks. Want to show off something more comprehensive? 4 spaces of indentation gets you there.

.awesome-thing {
    display: block;
    width: 100%;
}

Ready for a Break?

Throw 3 or more dashes down on any new line and you've got yourself a fancy new divider. Aw yeah.

Advanced Usage

There's one fantastic secret about Markdown. If you want, you can write plain old HTML and it'll still work! Very flexible.

That should be enough to get you started. Have fun - and let us know what you think :)

<?php

echo "Hello World\n";