Laravel開発環境をMacにセットアップしよう
VSCode、Docker、Git、Node.jsなどの必須ツールをインストール
コードエディタ
JavaScriptランタイム環境
バージョン管理システム
コンテナ環境
AIコーディングアシスタント
データベース管理ツール
公式サイトからVSCodeをダウンロードします。
高速なコード補完、型推論、エラー検出、定義ジャンプ、リファレンス検索が使えます。
⌘+Shift+X を押すHomebrewは、Macで使えるパッケージ管理ツールです。これを使ってNode.js、Gitなどをインストールします。
brew -v
バージョンが表示されれば既にインストール済みです。表示されない場合は以下のコマンドでインストールします。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
⚠️ 注意: インストール中にMacのログインパスワードの入力を求められる場合があります。
brew install node
node -v npm -v
💡 補足: Homebrewを使用してアップデート可能です: brew upgrade node
brew install git
git --version
Gitを使うために、ユーザー名とメールアドレスを設定します。
git config --global user.name "あなたの名前" git config --global user.email "your.email@example.com" git config --list
docker --version docker compose version
個人のGoogleアカウントなら無料で利用できます。
無料枠: 60リクエスト/分、1,000リクエスト/日
必ず個人のGmailアカウント（Workspaceではないアカウント）でログインしてください。Workspaceアカウントでは無料枠が利用できない場合があります。
公式ドキュメント
https://geminicli.com/npm install -g @google/gemini-cli
gemini
chmod -R 755 .
プロンプト内で `@` に続けてファイルパスを入力すると、そのファイルをコンテキストとして Gemini に渡すことができます。これにより、ファイルの内容に基づいた質問や指示が可能になります。
単一ファイルの例:
@routes/web.php このファイルを解説して
複数ファイルの例:
@app/Models/User.php @app/Http/Controllers/UserController.php リレーション確認
公式サイト
https://sequel-ace.com/node -v npm -v git --version docker --version docker compose version
cd ~/Documents git clone https://github.com/あなたのユーザー名/リポジトリ名.git cd リポジトリ名
cp .env.example .env
docker compose up -d docker compose exec app bash composer create-project laravel/laravel:"^12.0" . exit
src/.env
を編集します。
DB_CONNECTION=mysql DB_HOST=db DB_PORT=3306 DB_DATABASE=laravel DB_USERNAME=udemy123 DB_PASSWORD=pass123
docker compose down -v docker compose up -d
docker compose exec app bash php artisan migrate
エラー: "address already in use"
解決策: docker-compose.ymlのポート番号左側を変更します。
ports: - 8080:80 # Webサーバー - 3307:3306 # MySQL
アクセスURL: http://localhost:8080
エラー: "Cannot connect to the Docker daemon"
解決策: アプリケーションフォルダからDocker Desktopを起動します。
エラー: "SQLSTATE[HY000]"
解決策: src/.envの設定値をdocker-compose.ymlと一致させて再起動します。
docker compose down -v docker compose up -d
症状: 古い設定が残っている
解決策: -vオプション付きで削除します。
docker compose down -v docker compose up -d docker compose exec app bash php artisan migrate
⚠️ 警告: 本番環境では-vオプションは使用禁止です！
docker compose up -d
コンテナ起動
docker compose down
コンテナ停止
docker compose down -v
コンテナ停止＋ボリューム削除
docker compose exec app bash
appコンテナに入る
docker compose ps
起動中コンテナ確認
docker compose logs
ログ確認
exit
コンテナから出る