refirio.org

Homestead

※2019年ごろに検証した内容。2021年に改めて検証した内容は Laravel6.txt に記載している Homesteadをインストールするだけで Ubuntu16 + PHP7 + Nginx + MySQL の環境を構築できる ※Dockerによる開発環境構築は、Docker.txt の「その他の環境構築例」と「Laradockによる開発環境構築」を参照 Homesteadは、1つのPCに複数インストールできない（無理矢理インストールすることは不可能では無いようだが） よって案件名をもとにしたフォルダ内にHomesteadをインストールせず、「homestead」という場所にインストールして、 1つのHomesteadで複数のプロジェクトを管理する方が無難 詳細は「環境構築のトラブル事例」を参照 Laravel Homestead 5.5 Laravel https://readouble.com/laravel/5.5/ja/homestead.html ↑インストール方法など詳しく書かれている 【Laravel超入門】開発環境の構築（VirtualBox + Vagrant + Homestead + Composer） - Qiita http://qiita.com/7968/items/97dd634608f37892b18a Laravel HomesteadでLaravel5.4の環境を作りながら、レンタルサーバにwebアプリケーションを公開する(追記あり) - Qiita http://qiita.com/Fendo181/items/a6b9017f6ef490995aba Windows10でLaravel Homestead環境構築 - Qiita http://qiita.com/ricoirico/items/9745160bcf9983fa30ad Laravel Homestead - Laravel - The PHP Framework For Web Artisans https://laravel.com/docs/5.5/homestead 以下、VirtualBox + Vagrant の環境は構築済みとする ■Homestead Vagrant Box のインストール ■Homesteadのインストール ここでは C:\vagrant\homestead にインストールするものとする ※作業ファイルではなくHomesteadの仕組みそのもののインストールなので、 案件ごとの作業領域ではなく C:\vagrant\homestead などHomestead用の領域にインストールする方が良さそう インストールしたHomesteadのバージョンは、以下に記載されている C:\vagrant\homestead\Homestead\bin\homestead $app = new Symfony\Component\Console\Application('Laravel Homestead', '6.2.2'); ■鍵の作成 gitを使っているなら Git Bash で作成できる 恐らくPoderosaなどを使っても大丈夫と思われる WindowsでGitを始めたらまず確認！Git Bashの設定&ショートカット | 株式会社グランフェアズ http://www.granfairs.com/blog/staff/gitbash-setting-shortcut これで C:\Users\ユーザ名\.ssh 内に鍵ファイルが作成される。ここはHomesteadからみると ~/.ssh/ にあたる ■Homesteadの設定 C:\vagrant\homestead\Homestead\Homestead.yaml を編集する 鍵の設定は以下にあるが、上の手順で作成した場所がデフォルトとなっているため変更は不要 他の方法で鍵を作成した場合、必要に応じて設定を変更する ■hostsの設定 http://homestead.test/ でアクセスできるようにする C:\Windows\System32\drivers\etc\hosts ■Vagrantの起動 しばらく待つ…がエラーが表示された Windows10環境での不具合で、最新版のVirtualBoxでは修正されているらしい Windows8.1 から Windows10 にUpgrade して発生したvagrantのエラー - Qiita https://qiita.com/joniyjoniy/items/8176ece2b57c5a40121e https://www.virtualbox.org/ticket/14040 から VBox-Win10-fix-14040.exe をダウンロードし、管理者として実行。再度起動コマンドを試すとVagrantが起動した その後 http://homestead.test/ にアクセスすると、「No input file specified.」とだけ表示される いったん成功 Vagrantを終了する場合は以下のコマンド ■SSHで接続 「vagrant ssh」コマンドを使うと、SSHで接続するための情報が表示される Poderosaを使って以下の情報で接続する 以下を参考に時差の調整を行っておくといい Laravel Homesteadの日本時間設定をする - Qiita https://qiita.com/shalman/items/42fcd4506b1f523c5553 ■プロジェクトを作成 ※最初は案件用ではなく、動作確認用のプロジェクトを作成する方がいいかも その後、別途サブドメインと作業フォルダを作る方がいいかも C:\vagrant\homestead\code を作成 C:\vagrant\homestead\Homestead\Homestead.yaml を編集（folders の map のみ） この状態でVagrantを再起動 C:\vagrant\homestead\code\public\index.html を作成すると、これが http://homestead.test/ に表示される（SSH経由で /home/vagrant/code/public/index.html を作成しても同じ） このディレクトリの内容は C:\vagrant\homestead\code と同期している ここまで来れば最低限、Homesteadを開発環境として使用できる 以降で引き続き、Laravelのインストールを試す ■Laravelインストール いったん /home/vagrant/code/public/ を削除しておく 上でインストールしたLaravelの公開ディレクトリは /home/vagrant/code/laravel/public なので変更する Vagrantを再起動するも、設定は反映されない Homestead.yaml の sites 設定は「初回起動時にsitesの内容をもとに、Nginxの設定ファイルを調整する」という動作みたい つまり2回目以降、上記設定は無視される Laravel : Homesteadで開発環境を構築 | DN-Web64 http://www.dn-web64.com/archives/web/homestead/ 別途Nginxの設定ファイルを編集し、Nginxを再起動する 以下のURLでLaravelの画面が表示される http://homestead.test/ ■Laravel動作確認 引き続き、Composerやデータベース接続などを試す 以下のページも参考になりそう Laravel : Homesteadで開発環境を構築 | DN-Web64 http://www.dn-web64.com/archives/web/homestead/ 実際の作業環境追加は「Homesteadにサブドメインと作業ディレクトリを追加」の項目を参照 ■環境構築のトラブル事例1 vagrant up 後「Warning: Authentication failute. Retrying...」が出続けてタイムアウトエラーが出る （vagrant 自体は起動するがなんか気持ち悪い） [原因] ssh の秘密鍵とゲストOS で設定されている公開鍵が合っていない為発生。 [解決方法] http://kiraba.jp/vagrant-error-authentication-failure-retrying/ こちらのサイトの通りにやることで Warning は出ずに起動するようになった。 ■環境構築のトラブル事例2 vagrant が起動した後、サイトにつながらない （http://homestead.test/ が見れない） [原因] 一度不完全な状態で起動した（上記の Warning など）為、nginx の設定ファイルが正常に作成されていない為。 [解決方法] vagrant halt で一旦停止後、 で起動する。 --provision を付与することで再度 Homestead.yaml に沿って設定ファイルを作成してくれる。 これで http://homestead.test/ にアクセスすると「No input file specified.」が表示されるようになった。 vagrant up --provision すれば鍵の不一致も解決するかも（？）。 試していないので断定はできないが、あとで見ると鍵がコピーされていた。 ■環境構築のトラブル事例3 複数のHomesteadを起動できない 「homestead-7」はすでに存在すると言われた Oracle VM VirtualBox（GUIツール）を立ち上げて、以前作成した「homestead-7」を削除して、再度「vagrant up」を実行した Homesteadはそのままでは複数起動できないらしい box名を変更するなどの対応が必要らしい 1つのboxで複数のプロジェクトを管理する方が無難かも 同一のboxだとPHPのバージョンを変更したりが難しいが、 Homesteadは「特定の案件に合わせた環境を構築する」というより「最新版Laravelの開発環境を構築する」ものなので、 以下の方法でディレクトリを分ける程度の方がいいかも Homesteadを使って複数のLaravelプロジェクトを作成する簡単な方法 - Qiita https://qiita.com/Yorinton/items/08ec8fefcbec71513399 複数のLaravel環境をHomestead上で動かす - Qiita https://qiita.com/miutex/items/ebc13fc78da4a19a3da4 以下のような方法も紹介されているが、Homesteadがバージョンアップした場合に対応できなるなる可能性がありそう また、「何故か一部だけ動作しない」になったときに解決が難しいかも Laravel5.2のHomesteadを複数たててみた - Qiita https://qiita.com/you-me/items/b886dd0fc8e5047c4bc6 Homesteadを複数作りたい場合にやること - めものようなもの http://fumikony.hatenablog.com/entry/2015/04/22/145639 現状以下が良さそうかも ・Homestead環境は一つで、サブドメインで分岐させる ・例えば C:\localhost\home\homestead にHomesteadを配置して /home/vagrant/code と同期して、 /home/vagrant/code/laravel/public で最初のLaravelの動作確認をして、 /home/vagrant/code/test1/public /home/vagrant/code/test2/public などにプロジェクトを配置して laravel.homestead.test test1.homestead.test test2.homestead.test などでアクセスできるようにする。これなら過去案件への影響も小さい ・データベースも分ける ■環境構築のトラブル事例4 AWSのAPIを呼び出すと、以下のようなエラーになる サーバ時間のズレが影響しているようなので設定する 時差を調整してもエラーのままだったことがあるが、WindowsとVagrant自体を再起動するとエラーにならなくなった Laravel Homesteadの日本時間設定をする - Qiita https://qiita.com/shalman/items/42fcd4506b1f523c5553 Aws::RDS::Errors::SignatureDoesNotMatch というエラーが出た際の対処 | cloudpack.media https://cloudpack.media/20686 ■環境構築のトラブル事例5 EC2でLaravelのインストールに失敗する エラーメッセージにあるように、メモリ不足が原因 スワップを作成するか、マシンスペックを上げる