iT邦幫忙

2024 iThome 鐵人賽

DAY 2
1

安裝 Homebrew

我使用的是 macOS 系統,會使用 Homebrew 安裝 PHP、Composer 等等。
如果你跟我使用同樣系統,但還沒有安裝 Homebrew,可以使用以下指令來安裝:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

更多資訊可以參考 Homebrew 網站。

  • 菜雞仔如我,每次安裝完任何東西都需要檢查版本,確認自己真的有安裝成功:
brew --version

安裝 PHP

使用 Homebrew 來安裝 PHP:

brew install php

小提醒:Laravel 11 對 PHP 最低要求是8.2


安裝 Composer

Laravel 使用 Composer 來管理相關套件。一樣使用 Homebrew 來安裝 Composer:

brew install composer

安裝 Laravel Installer

使用 Composer 下載 Laravel 安裝套件:

composer global require laravel/installer

可以利用這個安裝套件輕易的建立好 Laravel 專案。


將 Laravel 安裝套件的路徑加入 $PATH

這樣可以在任何資料夾下創建新的 Laravel 專案,使用上比較方便。

我使用 VS Code 來編輯 Shell 設定檔案,首先需要確定使用的是哪個 Shell(如.bashrc.bash_profile.zshrc

可以通過輸入以下指令來檢查:

echo $SHELL

如果輸出的是/bin/zsh,那麼使用的是Zsh;如果是/bin/bash,則使用的是Bash。

一開始我也不知道 Shell 是什麼,菜雞仔如我,遇到新東西先 Google 或丟 GPT 查詢,當時有看到這篇鐵人賽其中的文章:shell 是什麼?
其中文章內容讓我能大概理解:「teminal.app 只是一個負責顯示與輸入指令的程式,你只是透過 terminal.app 將指令輸入, 而運行中的 shell 才是真正發送指令的人。」

備註:對於一些太困難理解的,我沒有深入鑽研,因為我覺得有些東西現階段的我可以初步了解就好。

打開 VS Code

  • 打開終端機的部分,輸入以下指令導航到主目錄:
cd ~
  • 已經確認我使用的是 Zsh,打開設定檔案:
code .zshrc
  • 在檔案裡放入以下程式碼:
export PATH="$HOME/.composer/vendor/bin:$PATH"
  • 保存並關閉設定檔案後,需要載入新的設定:
source ~/.zshrc

檢查 Laravel 安裝套件版本

laravel --version

確認出現版本後,就可以在任何資料夾下創建新的 Laravel 專案囉!


趕快來使用看看!

laravel new product  # 創建一個名為 "product" 的新專案

會新建一個 product 資料夾,並且新增好 Laravel 最基本的檔案。

接著,菜雞仔如我,當時就被出現的幾個詢問搞矇囉!

  • 英文不好的我趕快丟去 google 翻譯,看看題目跟選項是什麼意思。
  • 然後還丟去 GPT 詢問它會建議新手選擇什麼?(笑)

以下會整理 GPT 提供的建議回覆,當時的我真的很需要!
但已經初步了解 Laravel 的夥伴們可以跳過以下過程。

Laravel 專案創建過程選項解釋

開始創建新的 Laravel 專案時,會有幾個選項給你選擇:

 ┌ Would you like to install a starter kit? ────────────────────┐
 │ › ● No starter kit                                           │
 │   ○ Laravel Breeze                                           │
 │   ○ Laravel Jetstream                                        │
 └──────────────────────────────────────────────────────────────┘

在這個步驟中,它詢問你是否希望為新專案安裝一個 Starter Kit?
Starter Kits 是一些可以幫助你快速設定身份驗證和其他常見的功能。

你有三個選擇:

  1. No starter kit(不使用 Starter Kit):如果你想要從零開始構建,不需要預設的身份驗證和其他功能,可以選擇這個選項。(建議初學者選擇此選項)
  2. Laravel Breeze:會內建一個基本的身份驗證功能,比如會員註冊、登入登出、重置密碼等,適合快速開始並需要基本身份驗證的應用程式。
  3. Laravel Jetstream:提供更多的功能,包括團隊管理、雙重身份驗證等,適合更複雜的應用程式。
Which testing framework do you prefer? ─────────────────────────┐
 │ › ● Pest                                                     │
 │   ○ PHPUnit                                                  │
 └──────────────────────────────────────────────────────────────┘

在這個步驟中,是讓你選擇在新專案中使用哪個測試框架。Laravel 提供兩個選擇:

  1. Pest:一個簡潔且直觀的測試框架,旨在使測試編寫更簡潔且易於閱讀。適合那些希望以更簡單和直觀方式編寫測試的人。
  2. PHPUnit:一個強大且流行的測試框架,長期以來一直是 PHP 的標準測試框架,使用功能更全面。

儘管 Pest 更簡潔和直觀,但 PHPUnit 作為一個強大的框架,更適合初學者學習基本的測試概念和技術。

Would you like to initialize a Git repository? ──────────────┐
 │ ● Yes / ○ No                                              │
 └───────────────────────────────────────────────────────────┘

在這個步驟中,是詢問你是否希望在新專案中初始化 Git 儲存庫:

Git 是一種版本控制系統,可以幫助你追蹤和控制項目的版本變化。
對於初學者來說,建議選擇 "Yes",因為學習使用 Git 是一項重要的技能。

選擇完這些選項後,你的 Laravel 專案就已經創建完成,並且可以開始開發了,之後都可以依照自己的需求去做選擇。

此範例專案我選擇的選項是:

  • No starter kit
  • PHPUnit
  • Yes

運行 Laravel 專案

cd ~/projects/product  # 進入你剛剛創建的 Laravel 專案目錄
php artisan serve  # artisan 這個 Laravel 內建工具 開啟 PHP 內建開發環境伺服器。

你可以在瀏覽器中輸入 http://localhost:8000 來確認是否能正常查看你的 Laravel 網站。

到這裡,恭喜你已經向 Laravel 世界踏出第一步囉!

插撥一則內心喊話

如果小夥伴們跟我一樣不是本科系,之前工作也不是相關領域,剛開始什麼都看不懂很正常。
網路上找得到很多大神的文章內含詳細步驟,過往的鐵人賽裡也有很多資料!google 找不到的就直接丟 GPT 詢問,我有時候都會告訴我自己:沒什麼好丟臉的!
像我真的很菜!光是在安裝的時候就會碰到問題。
建議碰到錯誤訊息時,先好好思考一下我現在的問題是什麼?先找出你的問題在哪裡,你才知道該往哪個方向去找答案,判斷你找到的是不是可以解決你這個問題的答案,接著再去消化理解你所找到的答案。
在這個過程中總會慢慢進步!


上一篇
開賽前言
下一篇
初步了解 Laravel 目錄結構
系列文
後端菜雞仔想學 Laravel13
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言