UbuntuでPHP・mpsrをインストールしてLaravlを動かす方法#指示内容

UbuntuでLaravlを動かすには、最初に「PHP」「mpsr」「Laravl本体」の3つを正しく揃える必要がある。ここで大事なのは、単にコマンドを打って終わるのではなく、PHP拡張、mpsrの実行確認、.nv、APP_KY、開発サーバー起動まで一通り通すこと。最初の段階で土台を整えておくと、その後のMySQL導入やNginx/Apah構築、kr化にもつなげやすい。

最初に理解しておくこと

LaravlはPHP製のフレームワークなので、N.jsだけ入っていても動かない。必要なのは、PHP本体、PHP拡張、mpsr、そしてLaravlプロジェクト本体。
流れとしては、
・Ubuntuを更新する
・PHPを入れる
・mpsrを入れる
・Laravlプロジェクトを作る
・APP_KYを生成する
・開発サーバーを起動する
という順番で進めると整理しやすい。

Ubuntuのバージョンを確認する

最初に自分のUbuntuバージョンを確認しておくと、後でパッケージ名やPHPバージョンで迷いにくい。

lsb_release -a

または次でも確認できる。

cat /etc/os-release

初心者なら、サポート中のLTS版を使う方が安定しやすい。古いUbuntuだと、PHPや依存パッケージの扱いで余計につまずきやすい。

システムを最新状態にする

インストール前にパッケージ情報を更新し、既存パッケージも最新にしておく。ここを飛ばすと依存解決で失敗することがある。

sudo apt update
sudo apt upgrade -y

発生しやすいエラー条件は次の通り。
・別のapt処理が動いている
・sudo権限が無い
・古いパッケージ情報のまま進めて依存解決に失敗する

PHPをインストールする

Laravelを動かすにはPHP本体に加えて、よく使う拡張も必要になる。最初からまとめて入れておくと後が楽になる。

sudo apt install -y php php-cli php-common php-mbstring php-xml php-bcmath php-curl php-zip php-mysql unzip curl git

インストール後は、PHPが正しく使えるか確認する。

php -v

ここでの発生しやすい問題は、
・PHP本体だけ入れて拡張不足になる
・複数バージョンのPHPが混在していて想定外のPHPが呼ばれる
・zip や mbstring が足りず、後でComposerやLaravelが失敗する
というもの。

Composerをインストールする

Laravelのインストールや依存関係管理にはComposerが必須になる。まだ入っていない場合は、次の手順でインストールする。

cd ~
php -r “copy(‘https://getcomposer.org/installer’, ‘composer-setup.php’);”
php composer-setup.php
php -r “unlink(‘composer-setup.php’);”

この状態だとホームディレクトリに mpsr.phar が作られる。毎回 php mpsr.phar と打つのが面倒なら、システム全体で mpsr として使えるように移動する。

sudo mv composer.phar /usr/local/bin/composer

インストール確認は次で行う。

composer –version

発生しやすいエラー条件は、
・PHP拡張不足でComposerが警告を出す
・ネットワーク制限でインストーラ取得に失敗する
・/usr/lal/bin への移動権限が足りない
といったケース。

Composerの動作確認をしておく

Composerは入っただけで安心せず、一度診断コマンドを通しておくと後の切り分けがしやすい。

composer diagnose

ここで問題が出る場合は、Laravel導入に進む前に解消しておいた方が良い。
発生しやすい問題としては、
・PHP設定の不足
・CA証明書まわりの問題
・ネットワーク設定
・権限の問題
などがある。

Laravelプロジェクトを作成する

Composer経由でLaravelプロジェクトを作成する。初心者にはこの方法が最も分かりやすい。

composer create-project laravel/laravel myapp

作成が終わったらディレクトリへ移動する。

cd myapp

myapp は好きな名前に変更してよい。
ここでの発生しやすいエラー条件は、
・ディスク容量不足
・Composer依存解決エラー
・PHP拡張不足
・インターネット接続不良
といったもの。

.envファイルを確認する

Laravelプロジェクトが作成できたら、設定ファイルである .nv が存在するか確認する。

ls -la

通常は自動生成されるが、何らかの理由で無い場合は .nv.xampl からコピーする。

cp .env.example .env

.nv が無いまま進めると、APP_KYやB設定が読み込まれず、起動時にエラーになりやすい。

APP_KEYを生成する

LaravelではAPP_KEYが設定されていないと、暗号化、セッション、Cookie関連の処理が正常に動かない。
そのため、プロジェクト作成後は必ずキーを生成する。

php artisan key:generate

発生しやすいエラー条件は、
・.nv が無い
・書き込み権限が足りない
・APP_KYを生成しないまま起動しようとする
というもの。

開発サーバーを起動する

ここまでできたら、Laravelの内蔵開発サーバーを起動して動作確認する。

php artisan serve

通常は次のようなURLが表示される。

http://127.0.0.1:8000

ブラウザでそのURLを開き、Laravelの初期画面が表示されれば基本導入は成功。
別ポートにしたい場合は次のように指定できる。

php artisan serve –port=8080

発生しやすいエラー条件は、
・8000番ポートが既に使われている
・プロジェクトディレクトリ外で実行している
・APP_KEY未設定や vendor 不整合で起動失敗する
といったケース。

SQLiteで最低限のDB動作を試す

初心者が最初にMySQLまで入れると、DB設定でつまずくことがある。まずはSQLiteでLaravelのマイグレーションが動くか確認すると理解しやすい。

touch database/database.sqlite

.nv のB設定を次のように変更する。

DB_CONNECTION=sqlite
DB_DATABASE=/フルパス/your-project/database/database.sqlite

その後、マイグレーションを実行する。

php artisan migrate

発生しやすいエラー条件は、
・ファイルパスが相対パスのままで読めない
・sqliteファイルが存在しない
・設定変更後にキャッシュが残っている
というもの。

設定変更後はキャッシュを意識する

.nv や設定を変えたのに反映されない場合は、設定キャッシュが残っていることがある。
トラブル時はまず次を実行すると切り分けしやすい。

php artisan config:clear
php artisan cache:clear
php artisan route:clear
php artisan view:clear

まとめて消したい場合は次でもよい。

php artisan optimize:clear

特に、DB設定やAPP_URLを変えたのに動作が変わらないときは、まずここを疑う方が早い。

よくあるエラーと原因

UbuntuでPHP・Composer・Laravelを導入するときによくある問題は次の通り。
・mpsr: mman nt fun
→ mpsr未導入、またはPATH問題
・php: mman nt fun
→ PHP未導入
・Yur rquirmnts ul nt b rslv
→ PHP拡張不足、PHPバージョン不一致
・N appliatin nryptin ky has bn spifi
→ APP_KY未生成
・ Prmissin ni
→ ファイル権限不足
・ Fail t pn stram
→ vnr不足、stragやahの権限問題
初心者の場合、エラー全文を見る前に焦ってしまいがちだが、「コマンドが無いのか」「依存が足りないのか」「権限なのか」を分けるだけでもかなり整理しやすい。

初心者向けの最短手順まとめ

最短でLaravelを動かすだけなら、次の流れでほぼ十分。

sudo apt update
sudo apt upgrade -y

sudo apt install -y php php-cli php-common php-mbstring php-xml php-bcmath php-curl php-zip php-mysql unzip curl git

cd ~
php -r “copy(‘https://getcomposer.org/installer’, ‘composer-setup.php’);”
php composer-setup.php
php -r “unlink(‘composer-setup.php’);”
sudo mv composer.phar /usr/local/bin/composer

composer diagnose

composer create-project laravel/laravel myapp
cd myapp

php artisan key:generate
php artisan serve

この流れで初期画面まで表示できれば、Ubuntu上でLaravelを動かす最初の段階としては十分。

まとめ

UbuntuでPHP・ComposerをインストールしてLaravelを動かすには、
・Ubuntuを更新する
・PHP本体と必要拡張を入れる
・Composerを入れる
・Laravelプロジェクトを作る
・.nv と APP_KY を整える
・php artisan srv で起動する
という順番で進めると分かりやすい。
初心者がつまずきやすいのは、PHP拡張不足、mpsr未導入、APP_KY未生成、設定キャッシュの4つ。
ここを順番に確認できれば、Laravlの初期セットアップはかなり安定して進めやすくなる。