如何使用 PhpStorm 將專案發佈到 GitHub?

若要將專案發佈到 GitHub，實務上除了先在本機建立 local git repository 外，還要在 GitHub 建立 remote git repository，然後建立 remote branch，最後才能 push 到 GitHub，這些動作都可以在 PhpStorm 內簡單的完成。

Version

PHP 7.0

Laravel 5.2.39

PhpStorm 2016.1.2

Motivation

之前要將專案發佈到 GitHub，都是乖乖的下指令，但指令實在記不起來，只能複製貼上，在 如何使用 PhpStorm 部署 Laravel 到 Azure? 一文中，發現 PhpStorm 亦提供完整的圖形介面支援 Git 與 GitHub，讓我們可以使用更直覺的方式完成。

建立 Laravel 專案

啟動 PhpStorm，選擇 Create New Project 建立新專案。

• 專案類型 : Composer Project 。
• Location : Laravel 專案路徑與專案名稱
• composer.phar : 選擇 Use existing composer.phar ，輸入 /usr/local/bin/composer 。 ¹ 1 選擇 Download composer.phar from getcomposer.org 亦可，這種方式在 OS X 本機並不需要事先安裝 Composer，PhpStorm 會自動將 Composer 下載到目錄專案跟目錄下，唯此種方式安裝 package 將無法使用到 cache，必須從網路上下載，安裝時間較長，所以實務上建議使用 Use existing composer.phar 。
• Filter packages : 輸入 laravel/laravel ，此為 Laravel 專案的 package 名稱。

將畫面向下卷，還有其他設定。

• Version to install : 選擇 Laravel 版本， <default> 為 Laravel 最新版本。
• Path to PHP executable : 指定 PHP 執行檔路徑，主要為了執行 Composer。
• Command line parameters : Composer 參數，輸入 prefer-dist 。

建立 Laravel 專案中，由於 Composer 需解析 package 相依性，需要一些時間。

oomusou@mac:~/MyProject$ php artisan serve

執行 PHP 內建 Http Server。

Laravel 已經順利在 OS X 本機執行。

建立 Local Git Repository

實務上開發 Laravel 會搭配 Git 做版本控制，先在本機建立 local repository。

VCS -> Import ino Version Control -> Create Git Repository

建立 Git repository。 ² 2 相當於 git init 。

選擇 local repository 目錄，也就是目前專案目錄。

下方出現 Version Control ，並顯示有檔案尚未受 Git 管理，按 browse 顯示檔案。

選擇專案目錄，按 + (Add to VCS) 將檔案加入 stage。 ³ 3 相當於 git add . 。

綠色檔案為加入 stage 的檔案，按 VCS (Commit Changes)。

• 不要選擇 Perform code analysis 。
• Commit Message : Initial commit。

按 Commit 寫檔案寫入 local repository。 ⁴ 4 相當於 git commit -m "Initial commit" 。

Commit 成功後，下方會顯示 xx files committed : initial commit 。

建立 Remote GitHub Repository

將 local repository 上傳至 GitHub 建立 remote repository。

PhpStorm -> Preferences -> Version Control -> GitHub

設定 GitHub 帳號。

VCS -> Import into Version Control -> Share Project on GitHub

將專案發佈到 GitHub。

預設會使用專案名稱為 remote GitHub repository 名稱。

在 GitHub 建立成功。

在 GitHub 已經看到剛剛上傳的專案。

修改並 Push 到 GitHub

將 welcome.blade.php 加以修改，由 Laravel 5 改成 Hello Laravel 。

點擊下方的 Version control 標籤，按 VCS 將此次變更加以 commit。

填入 commit message 後，按 Commit and Push 。

按 Push 將直接 push 到 GitHub。

Push 到 GitHub 成功。

Conclusion

• PhpStorm 所提供的 Git 與 GitHub 支援或許不夠完整，但對於日常使用足足有餘，可大幅提高開發效率。

Sample Code

完整的範例可以在我的 GitHub 上找到。

Reference

• Mikhail Vink, Working with Windows Azure from within PhpStorm
• KevinAtStout, Connecting PhpStorm to Your Azure Web Server