如何將你的 Laravel boilerplate 專案成功部署到 HeroKu

事情是這樣的,最近在研究 HeroKu 這家雲端平台,想要嘗試將一些服務部署到 HeroKu 上頭,但卻遇到一些問題,因此將一系列的問題解決過程記錄下來 ...

Featured image

研究背景

事情是這樣的,最近在研究 HeroKu 這家雲端平台,想要嘗試將一些服務部署到 HeroKu 上頭,但卻遇到一些問題,因此將一系列的問題解決過程記錄下來。


HeroKu 是什麼?

Heroku是一個支援多種 程式語言 的雲 平台即服務 。在2010年被 Salesforce.com 收購。Heroku作為最開始的 雲平台 之一[1],從 2007年6月 起開發,當時它僅支援 Ruby ,但後來增加了對 JavaNode.jsScalaClojurePython 以及(未記錄在正式檔案上) PHPPerl 的支援。基礎作業系統是 Debian ,在最新的堆疊則是基於Debian的 Ubuntu [2]。

資料來源:Heroku - 維基百科,自由的百科全書

簡單來說,它就是提供一個平台讓你架設專案的服務,你只需要一個帳號,你就可以將你的 Laravel、MariaDB、Redis 一起架設上去,而且完全不收費,只是機器會睡覺而已,是個相當不錯的服務。


我應該怎麼開始?

首先你會需要申請一個 HeroKu 的帳號,HeroKu 會需要你的 First name、Last name、Email address、Role、Country 這些基本資料。

HeroKu 註冊網址:[Heroku Sign up](https://signup.heroku.com/login)

https://i.imgur.com/9Aeooh9.png HeroKu 註冊新會員

接下來我們會需要建立一個新的應用程式,然後把 Laravel、MariaDB、Redis 放到應用程式當中,將整個服務建置起來。

https://i.imgur.com/MOJLAZs.png 選擇「Create new app」

輸入你這應用程式的名稱,以及選擇伺服器所架設的地區。

https://i.imgur.com/DiSJbtt.png 設定 App 的名稱、位置

建立應用程式成功之後,你會看到你應用程式的儀表板,這裡記錄著所有的歷史紀錄,無論是錯誤訊息、設定更改或者建立新部署,現在假設我們需要部署新的 Laravel 環境上去 HeroKu 的話,我們先進入「Deploy」的地方。

https://i.imgur.com/xDf1vZw.png 應用程式的儀表板

你會看到 HeroKu 提供了多種部署方式,有 Heroku Git、GitHub、Container Registry 這三種方式,這次我們使用 GitHub 的方式來將專案部署上去。

https://i.imgur.com/lE0C0nZ.png HeroKu 提供多種部署方式

透過 GitHub 部署的方式很簡單,你只需要連接你的 GitHub,然後搜尋你要部署的專案,舉例來說我想部署 kantai235.github.io 這個部落格,我就直接搜尋「kantai235」然後 Search(搜尋),就能找到我的部落格專案,接下來直接按下「Connect(連接)」就能將專案部署到平台當中了。

https://i.imgur.com/X8xoLkb.png 透過 GitHub 部署到 HeroKu 平台當中。

不過這時候如果你的 Laravel 專案是以 rrappasoft/laravel-5-boilerplate 為基礎的話,那你會碰到一個問題,HeroKu 會告訴你「There are no commands defined in the “ide-helper” namespace.」,你部署到自己的電腦(localhost)當中是沒有問題的,但是你部署到 HeroKu 的時候卻發生了問題。

GitHub - rappasoft/laravel-5-boilerplate: A Laravel 5 Boilerplate Project - http://laravel-boilerplate.com

https://i.imgur.com/w2nHA5i.png There are no commands defined in the “ide-helper” namespace.

什麼是 ide-helper?他害我沒辦法部署!

基本上 Error Log 是在告訴你說專案可能在 composer 的 post-autoload-dump 這個階段出問題了,稍微查了一下 composer 文件,這個 function 的功能是「發生在自動載入器倒出之後,不管是在 install/update 期間,或經由 dump-autoload 命令。」,簡單來說 HeroKu 在一開始運行時會運行 composer install 這項指令,然後開始下載整個專案所有會用到的套件,下載完了以後,將會依序執行 post-autoload-dump 的所有指令,而 HeroKu 就是在這些指令當中出錯了,疑似是 @php artisan ide-helper:generate 這項指令出錯了。

https://i.imgur.com/0xTKKg0.png composer.json

Ide-helper 是一種會自動產生 IDE 文件的套件,簡單來說如果 composer 運行這些指令的話,ide-helper 會自動產生出一些魔術方法的文件給 IDE 讀取,讓你在開發的時候更為方便,語法提示跳得更多、提供更多的自動補完功能,但對於伺服器而言,這些文件是不必要的,因此你在部屬專案的時候,可以將 ide-helper 給拿掉(但沒辦法註解,因為 json 沒有註解),你就可以正常將專案部署到 HeroKu 當中了

GitHub - barryvdh/laravel-ide-helper: Laravel IDE Helper


參考文獻

Wikipedia contributors. (2019, April 13). Heroku. In Wikipedia, The Free Encyclopedia. Retrieved 01:30, May 7, 2019, from https://en.wikipedia.org/w/index.php?title=Heroku&oldid=892252710

Composer contributors. (2019, April 13). Composer. In 指令碼- Composer 正體中文文件. Retrieved 01:30, May 7, 2019, from https://getcomposer.ycnets.com/doc/articles/scripts.md

barryvdh contributors. (2019, April 13). barryvdh. In * barryvdh / laravel-ide-helper *. Retrieved 01:30, May 7, 2019, from GitHub - barryvdh/laravel-ide-helper: Laravel IDE Helper