可能有很多人不懂 Google 提供的 APIs 能做什麼，以及有哪些 Google APIs，只要到 Google Cloud Platform 就可以看到 Google 提供的所有 API，所有你想得到的 Google 服務，幾乎都有對應開放的 API，差別在於每個 API 使用的次數跟頻率有所限制，還有另一個是 Google 開放的 API 裡面「並不會」接露所有功能。

舉個 Google Maps 的例子，使用 Google Maps 時除了地圖、店家資訊及使用者評論等等，中間還有一個熱門時段，讓使用者可以清楚知道哪個時段會比較多人，就可以避開熱門時段，挑個比較少人的時間去，好友當時就是因為 Google Maps API 沒有提供這個功能，因此小蛙才幫忙用爬蟲的方式解決這個問題。

連上 Google Cloud Platform 可以看到很多各式各樣你想得到或想不到的服務

開啟 Google APIs

小蛙這系列都會用 Google Search Console 來當作範例，其他 API 原理基本上都差不多，只是呼叫的方式跟屬性設定有所不同，開始吧！

首先連到 Google Cloud Platform 從上方(1)選取一個要使用 API 的專案(2)，如果沒有專案的話可以建一個新的(3)

搜尋要開啟的 API (1)，點進去 (2)

點上面的 Enable 就可以開啟該 API 了，下面有一些 API 說明可以看看

API 成功開啟後，左邊的 Credentials 可以設定 API 認證的部份，不過這裡小蛙到第三篇文章的時候才會提到

測試 API 說明

回到剛剛啟動 Google Search Console API 的頁面，這次點選右邊 TRY THIS API

開出來的頁面是 Search Console URL Testing Tools API，不過小蛙這邊要用的不是這個 API，而是能取得 Google Search Console 裡面資料的 API，因此點選左上角 (1)

回到 Google Search Console APIs 首頁後進入 Search Console API

找到下面的 Try it in your browser

接著隨便點一個 api 功能

右邊會開啟一個側欄，這邊就是 Google API 的測試工具了，點選右上角的方框 (1) 可將螢幕放大顯示更多資訊

Google Search Console 原本就是以「網站」為目標，因此必填欄位是在 Search Console 裡面的網址 (1)，Request body 的部份填入查詢的參數 (2)，輸入完成後點選 EXECUTE 執行 (3)，下圖 (4) 的地方是真正發送出的 request

使用測試 API

小蛙用記下來 https://noter.tw/ 測試一下 (1)，填入一些必要的參數 (2) 取得 2021-05-01 ~ 2021-07-01 區間的資料，只要回傳前 10 筆就好，點選 (3) 的驚嘆號會顯示有哪些屬性可以設定，確定沒問題後 EXECUTE 送出吧！注意：這邊的 siteUrl 一定要是自己的 Search Console 原本就有的資源才可以，也就是說不能去查別人的，不然就太恐怖了！

點了 EXECUTE 後瀏覽器跳出登入畫面，有些可以透過 API Key 來使用，有些則是必須透過 OAuth 2.0 才可以使用，選擇一個帳戶來使用吧～

執行成功後，右上角會產生實際送出的 API

右下角則是顯示回傳結果，可以看見在這區間被點擊的次數為 46,812 次，搜尋曝光有 838,324 次 … 等

這看起來好像只能取到很基本的資料？不～來把參數做個調整，加上 aggregationType 及 dimensions 的設定回傳各個頁面的資訊～

查詢結果會根據區間內的點擊數排列，看看剛剛我們加的 dimensions 都在 keys 陣列裡面，包含搜尋字串、頁面、來源國家及日期

Google Search Console API 啟用跟測試就到這邊，下一篇將繼續介紹環境設定部份。

Google 系列文章：

• PHP Client 操作 Google APIs (1) 開啟與測試 API
• PHP Client 操作 Google APIs (2) 安裝 Google API Client for PHP
• PHP Client 操作 Google APIs (3) Google APIs Credentials 介紹
• PHP Client 操作 Google APIs (4) 使用 Google Search Console APIs
• Google 表單應用：設定選項次數上限
• 複製 Google 表單 (Copy A Google Form)
• Google Adsense: 向 Google 提交稅務資料 | 填寫 W-8BEN 稅務表單
• Google 雲端外帶服務 (Takeout)：輕鬆打包雲端硬碟、相簿 … 等資料
• Google 相簿取得真實圖片位置（插入圖片到文章）
• gdirve 讓你在 Linux 文字介面也能好好使用 Google Drive
• Microsoft Office Word 無法開啟 Google Drive 超連結

這篇文章 PHP Client 操作 Google APIs (1) 開啟與測試 API 最早出現於 記下來。

上一篇文章我們示範了怎麼使用 Google 提供的 API 測試工具，透過這些工具產生相關 REST 指令，同時 Google 也提供 Java 及 Python 版本的使用範例，只要點進 Google Search Console APIs 就可以看到。

但是小蛙今天要使用的不是 Java 及 Python，而是 PHP 版本的 Client (beta)，只要點進 Install Client Libraries 拉到下面可以看到各種版本的 Client，將頁籤切換到 PHP，或是其它自己擅長的語言～點選 Get the latest Google Search Console API client library for PHP (beta)

接著開啟 Github 頁面，PHP 版本需在 5.6.0 以上才可以使用，並且需要透過 composer 安裝，沒有 composer 的話可參考這邊。安裝好後使用以下指令安裝

composer require google/apiclient:^2.10

安裝完 PHP Client 後，在要使用 Google APIs 的 PHP 最上面加上

require_once '/path/to/your-project/vendor/autoload.php';

就可以載入 Google API 的相關工具了，如果沒有或真的不想裝 composer 的話，其實也有提供直接下載的版本，只要到 這邊 去下載適合的版本，解壓縮後同樣在要使用 Google APIs 的 PHP 加入上面 require_once (注意路徑正確性) 就可以使用 Google API 了。

接著建一個 PHP 檔案，新增一個 Google_Client() 物件出來，如果下載或設定正確的話，畫面上應該空白不會噴任何錯誤

<?php
 ini_set('display_errors', '1');
 error_reporting(E_ALL);
 // 換成自己的實際路徑
 require_once '../googleapiclient/vendor/autoload.php';
 $client = new Google_Client();
?>

如果出現下面這種錯誤，可能是沒安裝正確或是路徑指定錯誤，再檢查看看是哪裡有問題。

Fatal error: Uncaught Error: Class 'Google_Client' not found in /var/www/xxx.php:6 Stack trace: #0 {main} thrown in /var/www/test/xxx.php on line 6

這篇文章比較短，只著重在 PHP 版本的安裝，下一篇文章再繼續介紹怎麼使用 OAuth 登入並查詢 Google Search Console APIs 的相關資料！

Google 系列文章：

• PHP Client 操作 Google APIs (1) 開啟與測試 API
• PHP Client 操作 Google APIs (2) 安裝 Google API Client for PHP
• PHP Client 操作 Google APIs (3) Google APIs Credentials 介紹
• PHP Client 操作 Google APIs (4) 使用 Google Search Console APIs
• Google 表單應用：設定選項次數上限
• 複製 Google 表單 (Copy A Google Form)
• Google Adsense: 向 Google 提交稅務資料 | 填寫 W-8BEN 稅務表單
• Google 雲端外帶服務 (Takeout)：輕鬆打包雲端硬碟、相簿 … 等資料
• Google 相簿取得真實圖片位置（插入圖片到文章）
• gdirve 讓你在 Linux 文字介面也能好好使用 Google Drive
• Microsoft Office Word 無法開啟 Google Drive 超連結

這篇文章 PHP Client 操作 Google APIs (2) 安裝 Google API Client for PHP 最早出現於 記下來。

我們在前幾篇裡面瞭解了 Google APIs、安裝 Client for PHP 以及申請了 Google APIs Credentials 裡的 Service Account 並下載了 JSON (一定要好好保存，遺失了只能刪除再產生一次，沒辦法再次下載喔)，開始使用！

Google APIs 大致流程

使用 Google APIs 大致上的流程都差不多

• 載入 Google APIs Client for PHP (或其他語言版本)
• 加入 Service Account
• 建立並初始化物件
• 設定篩選條件
• 取得並解析結果

只要把握這幾個原則，之後若要使用 Google APIs 就不會再霧沙沙了 (但 API 還是要查，每個 API 的 Scope 跟條件設定上會有很大的不同)

載入 Google APIs Client for PHP

這個在前面 PHP Client 操作 Google APIs (2) 安裝 Google API Client for PHP 的時候已經講過了，在程式碼裡面很簡單，開頭放上這行就可以了，為了更方便 debug，可以多設定兩行條件，只要使用上出現錯誤，就會直接在網頁上呈現

// 顯示錯誤
ini_set('display_errors', '1');
// 所有錯誤都顯示
error_reporting(E_ALL);
// 載入 Google Client
require_once '../googleapiclient/vendor/autoload.php';

加入 Service Account

小蛙前面提到這次要做的事情是讓程式不經人工自動執行，而 Search Console 能使用的方式只有 OAuth 與 Service Account (忘記差別的這邊請 PHP Client 操作 Google APIs (3) Google APIs Credentials 介紹)，要不需人工介入只有 Service Account 了，而要讓 Service Account 存取 Search Console 資料的話，就必須將該帳號加入 Search Console 裡面囉！

首先進入 Search Console 要使用的資源，左邊選單下面找到「設定」

點擊「使用者與權限」

點擊「新增使用者」並把從 GCP Credentials 那邊得到的 Service Account 貼上，權限選擇「完整」

建立並初始化物件

回到 PHP 的部份加入金鑰及設定 Scope

// 設定金鑰
putenv('GOOGLE_APPLICATION_CREDENTIALS=存放金鑰的路徑/server_secrets.json');
session_start();

// 建立基本 Google Client 
$client = new Google_Client();
// 載入預設金鑰位置
$client->useApplicationDefaultCredentials();
// 設定 Scope
$client->addScope([Google_Service_Webmasters::WEBMASTERS_READONLY, Google_Service_Webmasters::WEBMASTERS]);
$client->setAccessType('offline');
// 建立基本 Google Service Webmasters 物件
$master = new Google_Service_Webmasters($client);

設定篩選條件

建立完要用的 Google Service Webmasters 物件之後，對！以前 Google Search Console 叫做 Google Webmaster，雖然我們說要操作 Search Console 但建立的物件跟設定的 Scope 可以看出都還是 Webmasters。

$search = new Google_Service_Webmasters_SearchAnalyticsQueryRequest();
$search->setStartDate( '2021-07-06' );
$search->setEndDate( '2021-08-06' );
$search->setDimensions( ['QUERY'] );
$search->setAggregationType( 'BY_PROPERTY' );
$search->setRowLimit(10);

至於有哪些條件或是要怎麼操作取得自己要的內容，就自己到 API Explorer 測試，或到 PHP Client 操作 Google APIs (1) 開啟與測試 API 複習吧！

取得並解析結果

最後把他們全部串起來～丟回的結果可以先用 print_r 印出來看看，或是直接到 這邊 看回傳的結果 ~

$data = $master->searchanalytics->query('https://noter.tw/', $search);

$result = [];
$rows = $data->rows;
foreach ($rows as $row){
    // 剖析資料
}

到這邊基本上就大功告成了，上面的功能是取得網站上特定區間的關鍵字資訊 ~ 需要其他資料的話，釣竿已經在手了，就要靠自己囉！Good Luck ~

Google 系列文章：

• PHP Client 操作 Google APIs (1) 開啟與測試 API
• PHP Client 操作 Google APIs (2) 安裝 Google API Client for PHP
• PHP Client 操作 Google APIs (3) Google APIs Credentials 介紹
• PHP Client 操作 Google APIs (4) 使用 Google Search Console APIs
• Google 表單應用：設定選項次數上限
• 複製 Google 表單 (Copy A Google Form)
• Google Adsense: 向 Google 提交稅務資料 | 填寫 W-8BEN 稅務表單
• Google 雲端外帶服務 (Takeout)：輕鬆打包雲端硬碟、相簿 … 等資料
• Google 相簿取得真實圖片位置（插入圖片到文章）
• gdirve 讓你在 Linux 文字介面也能好好使用 Google Drive
• Microsoft Office Word 無法開啟 Google Drive 超連結

這篇文章 PHP Client 操作 Google APIs (4) 使用 Google Search Console APIs 最早出現於 記下來。

小蛙這篇記錄從 GoDaddy 移轉到 Google Domains 的經過，盡可能記錄每一個步驟及遇到的問題，留給有需要的人！（原始的 GoDaddy 使用者依定要開啟二階段驗證啊啊啊！），整體的流程大致上分為

• GoDaddy 解除鎖定並設定轉出
• Google Domains 設定轉入
• GoDaddy 接受移轉
• Google Domains 驗證 Email

讓我們開始吧！

GoDaddy 解除鎖定並設定轉出

登入 GoDaddy，右上角選單中進入「我的產品」

找到要移轉出去的網址，點選旁邊的「管理」

拉到最下面，如果「網域鎖定」的地方是寫已開啟，一定要先按旁邊的編輯，把它改成關閉喔！小蛙就是因為漏掉這一步，結果同樣的步驟連續做了兩次 … 又因為截圖跟寫文章到一半當機，圖片都沒存到，掉了一些圖片，還好小蛙本來就要移轉兩個網域，所以下面的圖片有的是 crazyall.net 跟 wazai.net 穿插，不過步驟是沒問題的！

確定網域鎖定關閉之後，點選「將網域從 GoDaddy 轉出」

確保留在 GoDaddy 的 Email 是可以收到信的，因為等等會寄授權碼跟處理狀況去信箱

可以到信箱去收授權碼，也可以點這邊直接看授權碼

然後就會收到這封信，確認可開始進行移轉

Google Domains 設定轉入

連到 Google Domains 左方的選單切換到「移轉」頁籤，然後輸入要轉入的域名，按下 Enter 後

填入從 GoDaddy 拿到的授權碼

匯入網路設定，因為小蛙本來就沒有用 GoDaddy 管理設定，而是移交給 Cloudflare 來做管理（可以看使用 Cloudflare 代管你的域名），因此這邊勾選下面的「保留現有的網域名稱伺服器」，如果原本就用 GoDaddy 來管理的話，要選上面的喔！

勾選隱私保護服務，這個服務在 GoDaddy 可是要收錢的，Google Domains 佛心來的，免費送啊！而且一年只要 12 鎂，大概是台幣三百多，小蛙看了之前在 GoDaddy 的帳單，一年大約是五百多塊台幣，Google Domains 不僅送隱私保護，還更便宜，有什麼原因不轉呢？

開始結帳，如果是第一次結帳的話，會需要填寫聯絡資訊，第二次之後就可以用選的，因為小蛙一開始當機，所以 … 之前截得畫面不見了，付款方式填入信用卡就可以了。

結完帳之後會看到這個畫面

GoDaddy 接受移轉

再來回到 GoDaddy，前面兩個步驟做完之後，GoDaddy 這邊要確認接受移轉，才會把主控權轉移給 Google Domains，找到網域 -> 待處理的帳戶變更（GoDaddy 的選單設計得很糟，小蛙常常找不到要找的選單，有時候點一點又感覺跳到另一個系統 ><）

接著切換到「轉出」，勾選要轉出的網域名稱，按下「接受轉移」

收到通知說 15 分鐘後生效，但小蛙操作的時候沒有那麼久，只過一下下就寄 Email 來通知完成了

然後 … 就會收到 GoDaddy 寄來一堆 Email，第一封告知已經完成轉移動作了

第二封說討厭你離開，降價快回來

第三封說你終止了產品

第四封 … 也是降價的 promo code～ 到這邊整個域名已經成功從 GoDaddy 移轉出來了。

Google Domains 驗證 Email

這時候會收到一封 Google Domains 寄來的信，要求你驗證 Email，否則剛剛轉移來的 Domain 在 15 天後失效

驗證完之後就大功告成了！成功從 GoDaddy 移轉域名到 Google Domains 囉！！！

雖然上面圖片看起來步驟很多，但是實際做起來沒有那麼複雜，仔細想一下也算是合理

• 先跟 GoDaddy 說要移出
• 拿到 GoDaddy 授權碼
• 跟 Google Domains 說我要移入喔
• 給 Google Domains 授權碼
• Google Domains 說不能白做工，移來要續約一年
• Google Domains 設定好，等待 GoDaddy 確認中
• 到 GoDaddy 確認移出動作
• Google Domains 說要驗證 Email 喔，不然根據規定會失效
• 完成移轉！

十分鐘以內就完成這些動作了，去 whois 查詢可以看到註冊商已經變成 Google 了！帥呀！老皮～

這篇文章 GoDaddy 掰啦～從 GoDaddy 移轉網域到 Google Domains 最早出現於 記下來。

昨天要下班前又過期了，早上實在受不了，花一點時間 survey 相關資料，來讓他自動展延～這邊先說明小蛙的環境，主要的 code 會放在下面，再依照自己的需求修改使用。

• crontab -e 每兩個月（或每一個月）去做更新
• 更新時需要拿舊的 token 去換新的回來
• 將取回的新 token 存到一個檔案
• JSP 後台則從上述檔案中取得 token 以做後續處理

大概了解小蛙要做的事情之後就開始吧！

建立 token 檔案

小蛙把 token 放在 JSP 專案下的某個目錄，例如：WEB-INF/conf/token，把現有存活可用的 token 先貼進去，小蛙是直接把 facebook 回傳的 json 處理好之後，只留 token，不留其他 json 資訊（當然你要把 facebook 回傳的 json 全部留下來，之後在程式中處理也是可以，不過下次要更新的時候就要在 bash 中處理）

撰寫 bash 及加入排程

建立一個新檔案 update_fb_token.sh，並填入以下內容，這裡的重點只有 Facebook 那串網址，其他的部份根據自己的需求修改即可

#!/bin/bash
otoken="$(head -n 1 上面建立的token位置)"
url="https://graph.facebook.com/oauth/access_token?client_id=你的app_id&client_secret=fb後台登入後可以看到&grant_type=fb_exchange_token&fb_exchange_token=$otoken"
json=$(curl -X GET $url)
ntoken=$(echo $json | sed -E 's/.*"access_token":"([^"]*).*/\1/')
if [ ! -z "$ntoken" ]
then
        echo $ntoken > 上面建立的token位置
fi

上面的步驟簡單說一下，首先從本機 token 位置中讀取目前 token，連同 client_id、client_secret（這兩個 Facebook 後台都可以找到）去跟 Facebook 要一個新的 token，取得 Facebook 回傳的 json 後，小蛙只有簡單判斷能不能取到 access_token，如果有的話用 sed 擷取出來，並判斷不為空的話才更新到本機的 token 檔案裡，這裡可以根據自己的需求去做額外處理。

設定為可執行然後加入到 crontabe -e 定期執行

chmod +x update_fb_token.sh
crontab -e
# 每月 20 號 0:00 執行
0 0 20 * * /root/update_fb_token.sh

怎麼使用

小蛙這篇不打算講 OpenGraph 要怎麼使用，只是針對既有使用 OpenGraph 要每兩個月更新 token 的麻煩事，做了一個取巧的排程解法～已經把 token 存到一個指定的路徑中了，只要在使用 Facebook SDK 的地方，修改成動態載入這個 token 就可以正常運行了！省了很多麻煩～～

這篇文章 排程自動更新 Facebook Token 最早出現於 記下來。

【六、取得最新檔案(fetch, merge, pull)】

在開發程式的時候，可能在同一時間有許多工程師做修改的動作，剛開始可以先用 fetch 指令來查看看遠端倉儲中是否有較新的檔案。如果有最新檔案，可以使用合併(merge)來將檔案合併到目前本地倉儲。fetch 跟 pull 的功能非常類似，fetch 負責檢查遠端倉儲中是否有更新版本的檔案，接著讓工程師手動合併檔案；而 pull 則是先呼叫 fetch 檢查有無新版本後，由系統自動做合併動作，也就是 pull = fetch + merge。遇到無法解決的衝突(conflict)才需要透過手動處理。

開始改動檔案前先檢查是否有檔案版本是否有更新。滑鼠右鍵 -> TortoiseGit -> Fetch

「64f1f65..7c8a8af master  ->  origin/master」表示有檔案更新(如上圖)，並且已經將檔案儲存在暫存區。下圖[up to date]則是表示目前本地倉儲中的檔案已經是最新版本(與遠端倉儲一致)。

(此步驟目的在檢查版本差異，可跳過直接進入第5點合併差異)如果沒有版本更新就可以不用理會，若有版本更新要處理，可透過滑鼠右鍵「TortoiseGit」選單，接著點選「Diff with previous version」來查看有哪些內容的變更。

點選「RefBrowse」設定要比較的來源檔案，將 Version 1 設定成遠端倉儲分支，Version 2 設定成本地倉儲分支。

設定完 Ref 後，如下圖，下方的框框會顯示這兩個版本有哪些變動。(修改了README.txt，以及多了一個 newFile.txt 檔案。在檔案上點選滑鼠左鍵兩下，可以看到兩個版本的檔案內容比較。

開始進行合併動作，滑鼠右鍵「TortoiseGit」選單 ->「Merge…」，選擇要合併的分支，並填寫 Merge Message。如果沒有發生衝突，合併完成後會出現 Success 字樣。

接著我們嘗試使用 pull 來更新並合併版本庫。滑鼠右鍵「TortoiseGit」選單 -> 「Pull…」。選取遠端要 pull 的倉儲分支，出現 Success 的字樣表示成功合併。

【七、衝突情況】

衝突是使用版本控制經常遇到的情況，以下將介紹衝突處理方式。

如下圖，當 push 檔案回遠端倉儲時，出現以下錯誤訊息。

當 push 發生衝突時，可以透過 (1) fetch+merge 或 (2) pull 來解決。以下只說明使用 fetch + merge 處理方式( pull 操作較為簡單，可自行練習使用)。

滑鼠右鍵「TortoiseGit」選單 -> 「Fetch…」

從遠端倉儲抓了較新的資料，接著我們把他和我們的版本合併在一起。滑鼠右鍵「TortoiseGit」選單 -> 「Merge…」。From的部份要選擇遠端的分支，例如：remotes/origin/master，填入Merge Message。

系統自動執行合併時發現有衝突，導致無法自動合併。關閉視窗後，可以看到衝突的檔案變成黃色三角形驚嘆號。

在 newFile.txt 上點選滑鼠右鍵開啟「TortoiseGit」選單 -> 「Diff」，即可開始編輯有衝突的部份(符號說明)，修改完成後儲存檔案。

接著把剛剛做的變更 commit 到本地倉儲中。

將本地倉儲的變更 push 到遠端倉儲，以上為衝突發生時的處理流程。

本文完。有很多情況下沒辦法使用 GUI 介面，可到參考資料1, 參考資料2, 參考資料3，這三篇文章涵蓋了幾乎所有新手會遇到的問題！

參考資料

1. Git 教學(1) : Git 的基本使用 @ 好麻煩部落格http://gogojimmy.net/2012/01/17/how-to-use-git-1-git-basic/
2. Git 教學(2)：Git Branch 的操作與基本工作流程 @ 好麻煩部落格http://blog.gogojimmy.net/2012/01/21/how-to-use-git-2-basic-usage-and-worflow/
3. Git 情境劇 @ 好麻煩部落格http://blog.gogojimmy.net/2012/02/29/git-scenario/

Git 系列文章：

• Git GUI – (1) TortoiseGit, msysgit 安裝
• Git GUI – (2) 設定、Clone、Add、Modify
• Git GUI – (3) branch、conflict、merge
• Git GUI – (4) fetch、merge、pull、解決衝突情況(conflict)
• [參考文章] 使用 Git 做為網站開發版本控管工具

這篇文章 Git GUI – (4) fetch、merge、pull、解決衝突情況(conflict) 最早出現於 記下來。

【四、建立分支(branch)】

如果有新功能要開發或是既有功能修改，但又不想影響到主要程式(master)的運作，這時候可以透過建立分支(branch)，所有的修改動作都在「分支」中進行，各個分支是獨立作業的。比如要開發某個大功能，大功能中又切分很多細小的功能，我們可以在主線分支(master)下建立一個大功能分支，接著在大功能分支下，又切出許多細小功能的分支，也可以在分支的下面建立更細的分支，形成多重架構。當分支開發、測試結束後，再透過合併(merge)的動作，將所有分支合併回主線分支(master)，或透過重造(rebase)的動作，將目前開發的分支(branch)提升為主線分支(master)。

在E:\GitDaal\下點選滑鼠右鍵，接著選取「Create Branch…」。

輸入分支名稱，例如：newBranch。如果是要建立其它分支下的分支，Base On 的部份選擇 Branch 的選項，再選擇要基於哪個分支下建立新分支，這邊由於我們是基於主線分支(master)建立分支，因此選擇「HEAD (master)」。將「Switch to new branch」打勾，當分支建立完成後，會將目前的環境切換到新建立的分支下。

在新分支中編輯的東西，並不會影響到主線分支(master)，當編輯到一段落，將新分支中的東西 commit 到本地倉儲(commit 請參考三、修改(新增)檔案)。點選滑鼠右鍵，選擇「Git Branch」->「master」可快速切換至 master。master 看見的 README.txt 與 newBranch 看見的 README.txt 是不一樣的。

如果不知道自己現在身處於哪個分支，只要點選滑鼠右鍵，就可以在上方紅色框框看到目前所在分支。「Git Branch」子選單下有打勾的就是目前分支。以及「Git Commit -> “newBranch”」也可以看到現在是在 newBranch 分支下。

【五、合併分支 (merge) 並解決衝突 (conflict)】

當新的分支開發到一個段落時，Git 可以提供我們合併(merge)的功能，意即將目前分支(newBranch)開發的結果合併到主線分支(master)。

滑鼠右鍵選單->「TortoiseGit」->「Merge」

Branch 部份選擇要被合併的分支，我們要把 newBranch 合併回 master，因此選擇 newBranch。

若出現 Success 的字樣表示合併完成，沒有出現衝突的情況。此時視情況是否保留該 branch (可以理解成分支開發的子功能已經「加入」主線分支，該支線是否繼續保留開發功能或功成身退)。

如果合併時產生衝突(Conflict)的錯誤訊息，表示必須使用手動的方式來處理衝突。衝突的檔案會出現黃色三角形驚嘆號的圖樣。

在衝突的檔案上，開啟滑鼠右鍵 TortoiseGit 選單中的「Diff」。左邊是倉儲中上一個版本的檔案內容，只有五行內容，右邊則分為兩部分，從「<<<<<<< HEAD」到「=======」，表示最新版本中的內容，有六行內容，而「=======」到「>>>>>>> newBranch」是要合併的分支中的內容。此處視情況修改檔案內容，並把「<<<<<<< HEAD」「=======」「>>>>>>> newBranch」符號拿掉後存檔即完成修改。

修改完將檔案 commit 回本地倉儲。

接著選取滑鼠右鍵選單中的「Git History」，如下圖，上方為目前Git的分支狀況，修改者以及修改時間…等，下方為修改內容以及註解…等等資訊。

下一篇文章：Git GUI – (4) fetch、merge、pull、解決衝突情況(conflict)

參考資料

1. Git 教學(1) : Git 的基本使用 @ 好麻煩部落格http://gogojimmy.net/2012/01/17/how-to-use-git-1-git-basic/
2. Git 教學(2)：Git Branch 的操作與基本工作流程 @ 好麻煩部落格http://blog.gogojimmy.net/2012/01/21/how-to-use-git-2-basic-usage-and-worflow/
3. Git 情境劇 @ 好麻煩部落格http://blog.gogojimmy.net/2012/02/29/git-scenario/

Git 系列文章：

• Git GUI – (1) TortoiseGit, msysgit 安裝
• Git GUI – (2) 設定、Clone、Add、Modify
• Git GUI – (3) branch、conflict、merge
• Git GUI – (4) fetch、merge、pull、解決衝突情況(conflict)
• [參考文章] 使用 Git 做為網站開發版本控管工具

這篇文章 Git GUI – (3) branch、conflict、merge 最早出現於 記下來。

安裝完 TortoiseGit 及 msysgit 之後，即可開始使用 TortoiseGit 來管理專案，本範例主要描述如何使用 TortoiseGit 來管理既有專案，包括從遠端倉儲複製資料(clone)，操作本地倉儲(add, commit)，操作遠端倉儲(push)以及處理衝突(conflict)。

【一、基本設定】

在本機電腦上新增一個資料夾，例如：E:\GitDaal\，進入該資料夾，點選滑鼠右鍵，選取 TortoiseGit -> Settings。

輸入個人資料(Config)，名稱及電子郵件。

設定遠端伺服器(Remote)，Remote name可以隨便輸入，輸入您的 git Url 後點選 Add New，設定完成後按確定關閉設定視窗。

【二、從遠端倉儲複製檔案 (Git Clone)】

進入剛剛新增的 E:\GitDaal\ 資料夾，點選滑鼠右鍵選取「Git Clone…」。

填入您的 Git URL，按下 OK 開始複製遠端倉儲的目錄及檔案。

看到 Success 表示目錄及檔案複製成功。

可看到 E:\GitDaal\ 資料夾及以下所有資料夾都有綠色圓圈的勾勾，表示所有檔案都複製完成，綠色表示目前工作目錄的檔案與本地倉儲的檔案一致。

【三、修改(新增)檔案】

下圖為 Git 工作流程，本範例中的 E:\GitDaal\ 即為工作目錄(working directory)，經過編輯的檔案必須先透過存放進暫存區(staging area)後才可以成功儲存至本地倉儲(local repository)，也只有在本地倉儲中的檔案及資料，才可以透過推送(push)的方式分享到遠端倉儲(remote repository)。

用文字編輯器開啟剛剛透過 Git Clone 複製下來的 README.txt，修改完後存檔關閉檔案。(E:\GitDaal\README.txt)例如增加文字 ” Git test by Hans”。

可以看到從原本的勾勾變成紅色圈圈驚嘆號，表示目前「工作目錄中」的檔案已經和「本地倉儲中」的檔案不一致了。

TortoiseGit 簡化了上圖中 git add 指令，因此透過 TortoiseGit 可以直接做 commit 到本地倉儲的動作。點選滑鼠右鍵，選擇 Git Commit -> “master”

開啟 Commit 介面，Message 部份填入這次 Commit 的資訊，TortoiseGit 會將工作目錄中所有被修改過的檔案列在下方的列表中，這邊我們只更動了 README.txt 檔案，打勾表示同意將該檔案 commit 至本地倉儲。

出現  Success 表示檔案已成功 commit 到本地倉儲。TortoiseGit 為了讓使用者更方便，提供了左下角的 Push 按鈕，使用者可直接將檔案 push 到遠端倉儲，如果不想在此時 push，按下滑鼠右鍵的 TortoiseGit 選單中也有 push 的指令可選擇。

如果要增加新的遠端倉儲，可以點選「Manage」新增。點選 OK 之後如果出現 Success 字樣表示這次的 push 完成。

如果沒有出現 Success 可能是發生了衝突(conflict)，請參考 Git GUI – (4) fetch、merge、pull、解決衝突情況(conflict)。

下一篇文章：Git GUI – (3) branch、conflict、merge

Git 系列文章：

• Git GUI – (1) TortoiseGit, msysgit 安裝
• Git GUI – (2) 設定、Clone、Add、Modify
• Git GUI – (3) branch、conflict、merge
• Git GUI – (4) fetch、merge、pull、解決衝突情況(conflict)
• [參考文章] 使用 Git 做為網站開發版本控管工具

參考資料

1. Git 教學(1) : Git 的基本使用 @ 好麻煩部落格http://gogojimmy.net/2012/01/17/how-to-use-git-1-git-basic/
2. Git 教學(2)：Git Branch 的操作與基本工作流程 @ 好麻煩部落格http://blog.gogojimmy.net/2012/01/21/how-to-use-git-2-basic-usage-and-worflow/
3. Git 情境劇 @ 好麻煩部落格http://blog.gogojimmy.net/2012/02/29/git-scenario/

這篇文章 Git GUI – (2) 設定、Clone、Add、Modify 最早出現於 記下來。

【安裝TortoiseGit】

TortoiseGit 這個工具是由著名的 Tortoise 所開發，讓使用者在 Windwos 環境下可透過圖形化的操作方式，簡化了以往操作 Git 需透過命令列下指令的麻煩。

下載 TortoiseGit-1.5.8.0-32bit.msi，下載位址。(http://download.tortoisegit.org/tgit/)

開始安裝，預設安裝即可，安裝完重新啟動電腦。

安裝完 TortoiseGit 重新開機。

【安裝msysgit】

下載 Git-1.7.3.1-preview20101002.exe，下載位址。(http://msysgit.github.io/) 

開始安裝 Git。

SSH 工具的選擇，請選擇「Use (Tortoise)Plink」的選項，並且將路徑指定到剛剛安裝的 TortoiseGit\ 目錄下的TortoisePlink.exe。

安裝完成後重新啟動電腦。

下一篇：Git GUI – (2) 設定、Clone、Add、Modify

Git 系列文章：

• Git GUI – (1) TortoiseGit, msysgit 安裝
• Git GUI – (2) 設定、Clone、Add、Modify
• Git GUI – (3) branch、conflict、merge
• Git GUI – (4) fetch、merge、pull、解決衝突情況(conflict)
• [參考文章] 使用 Git 做為網站開發版本控管工具

參考資料

1. Git @ 維基百科http://zh.wikipedia.org/wiki/Git
2. tortoisegit @ Google Project Hostinghttps://code.google.com/p/tortoisegit/downloads/list
3. msysgit @ Google Project Hostinghttps://code.google.com/p/msysgit/downloads/list?can=3
4. Git 教學(1) : Git 的基本使用 @ 好麻煩部落格http://gogojimmy.net/2012/01/17/how-to-use-git-1-git-basic/
5. Git 教學(2)：Git Branch 的操作與基本工作流程 @ 好麻煩部落格http://blog.gogojimmy.net/2012/01/21/how-to-use-git-2-basic-usage-and-worflow/
6. Git 情境劇 @ 好麻煩部落格http://blog.gogojimmy.net/2012/02/29/git-scenario/

這篇文章 Git GUI – (1) TortoiseGit, msysgit 安裝 最早出現於 記下來。

使用 Git 做為版本控管非常好用，網路上有很多 Git 教學文：
【Git and Github 演講投影片(2011) @ ihower { blogging }】
【Git 教學(1) : Git 的基本使用 @ 好麻煩部落格】
【Git 初學筆記 – 指令操作教學 @ Tsung’s Blog】

這篇文章參考自【A web-focused Git workflow @ joe maller.com 】，以下文章指令輸入的部份源自於原始網頁，說明的部分是小蛙破英文翻過來的(只挑部份，沒有逐字翻)，連結到原始作者網頁可看到更多資訊。

這邊原作者把架構拉開分成 3 種身份(點回作者網站可以看到架構圖)：Clones(副本)、Hub(匯整)、Prime(網站)。

大致上的流程為：所有開發者從 Hub clone 一份下來開發，最後 push 回 Hub，再由 Hub 中的 hook 進入 Prime 的目錄下執行 pull，當 Prime 有 commit 動作時，也透過 hook 將變動 push 到 Hub 以維持兩個 repository 的一致性。

Hub: bare repository，其他開發者只能從這邊 clone 資料。

Prime: standard repository，網站的目錄。

安裝並設定 Git

git config --global user.name "Joe, working on the server"

在網站目錄下初始化一個新的 Git repository (Prime)

cd ~/www
git init
git add .
git commit -m"initial import of pre-existing web files"

在網站目錄之外的地方建立一個 bare repository (Hub)

cd; mkdir site_hub.git; cd site_hub.git
git --bare init
Initialized empty Git repository in /home/joe/site_hub.git

從 Prime 目錄下，把 Hub 加入到 remote 中，並且把 Prime 上的 master push 到 Hub 上

cd ~/www
git remote add hub ~/site_hub.git
git remote show hub
* remote hub
  URL: /home/joe/site_hub.git
git push hub master

為了讓 hub 跟 prime 緊密連接在一起，且不影響到工作目錄結構，這邊作者在 Hub repository 上設定 post-update (參考資料2)，當 Hub 接收到更新(git push)時，便會切換到網站目錄(prime)下的 repository 執行 git pull 的動作

#!/bin/sh
echo
echo "**** Pulling changes into Prime [Hub's post-update hook]"
echo
cd $HOME/www || exit
unset GIT_DIR
git pull hub master
exec git-update-server-info

在 Prime repository 中加入 post-commit (參考資料2)，為了維持 hub 跟 prime 雙向一致，如果真的 Prime 被手動修改了，也可以立即將這個變動發送到 Hub 上，讓 Hub 知道這些變動，避免 conflict

#!/bin/sh
echo
echo "**** pushing changes to Hub [Prime's post-commit hook]"
echo
git push hub

有一些情況下 Prime 跟 Hub 會發生不一致的情況，作者提到如果衝突發生時，最好的做法是先把目前發生問題的 Prime 的狀態 push 到 Hub 的 “fixme” 分支，如此一來其他的 clones 就可以把有問題的分支 pull 下來，處理完成後再 merge，以免因為 Git 的衝突標示使得網站無法正常運作

git push hub master:refs/heads/fixme

由於 Prime 的 .git 資料夾在網站的根目錄可能會有安全性的問題，使用 Apache 的話可以透過以下方式禁止 .git 被存取

# deny access to the top-level git repository:
RewriteEngine On
RewriteRule \.git - [F,L]

如果看到以下錯誤，就把 export PATH=${PATH}:~/bin 加入到 Server 上的 .bashrc 中。

git-receive-pack: command not found
fatal: The remote end hung up unexpectedly

參考資料

1. A web-focused Git workflow @ joe maller.com
   http://joemaller.com/990/a-web-focused-git-workflow/
2. Git Hooks @ Git Book 中文版
   http://gitbook.liuhui998.com/5_8.html
3. Git @ 維基百科，自由的百科全書
   http://zh.wikipedia.org/wiki/Git
4. Git and Github 演講投影片(2011) @ ihower { blogging }
   http://ihower.tw/blog/archives/5391/
5. Git 教學(1) : Git 的基本使用 @ 好麻煩部落格
   http://gogojimmy.net/2012/01/17/how-to-use-git-1-git-basic/
6. Git 初學筆記 – 指令操作教學 @ Tsung’s Blog
   http://blog.longwin.com.tw/2009/05/git-learn-initial-command-2009/

Git 系列文章：

• Git GUI – (1) TortoiseGit, msysgit 安裝
• Git GUI – (2) 設定、Clone、Add、Modify
• Git GUI – (3) branch、conflict、merge
• Git GUI – (4) fetch、merge、pull、解決衝突情況(conflict)
• [參考文章] 使用 Git 做為網站開發版本控管工具

這篇文章 [參考文章] 使用 Git 做為網站開發版本控管工具 最早出現於 記下來。