はじめに（この記事について）
この記事は、OpenAI が開発した生成AIモデル ChatGPT (GPT-5 ?) によって作成された原稿をもとに執筆しています。
私（著者）は、生成AIと対話しながら考えを深め、整理し、Laravel での実装に落とし込んでいく過程をそのままブログ記事としてまとめました。
タグ: Laravel
はじめに
AWS S3 を今まで使ったことがありませんでした。テキトーに使い始めてみたら、何やらよくわからないエラーで手間取ってしまいました。そこで、基礎の部分から調べてみようと思い、本投稿を残します。
特に、なぜか S3 フォルダを作成できない問題を解消したかったのでした。
まとめ
- S3 フォルダの作成するために
Storage::disk('s3')->makeDirectory($directory);などと実行すると400 Bad RequestAccessControlListNotSupportedのエラーとなった。- これは Laravel 設定ファイル
laravel/config/filesystems.phpにて'visibility' => 'private',を設定することで解消できた。 - 調査 → makeDirectory AccessControlListNotSupported – Google 検索
- これは Laravel 設定ファイル
直面した問題
環境
- WLS2 (その後 Mac でも実施)
- Vue – アセットの構築（Vite） 9.x Laravel のところまで設定を進めた。
npm run prod の場合は、静的ファイルを書き出してそのファイルへのリンクを HTML ファイルへ埋め込むようになっています。よって、ビルドされたファイルへのリンクは Laravel へアクセスするときの Apache なり Nginx なり PHP ビルトインサーバなりの URL と同じ URL が埋め込まれ、この URL でアクセスできるため問題はありません。
一方で、 npm run dev の場合は、 Vite の開発サーバが別途立ち上がります。そして Vite でビルドされたファイルへアクセスするための埋め込みリンクは、 Vite の開発サーバの URL となります。
Docker を使う場合、 Docker ホスト側から Docker コンテナ内の Vite 開発サーバへどうやってアクセスするのかが、問題になりました。
例えば、カスタマイズしていない vite.config.js で npm run dev すると次のようになります。
- URL は次のように表示された。
- VITE ➜ Local: http://localhost:5173/
- LARAVEL ➜ APP_URL: http://localhost
- Docker ホストにて、ウェブブラウザで
http://localhost/にアクセスすると画面真っ白になった。 - ページのソースコードを見てみると、 Vite でビルドされたファイルへのリンクは
<script type="module" src="http://127.0.0.1:5173/resources/js/app.js"></script>となっていた。この URL にアクセスしてみても ERR_CONNECTION_REFUSED のエラーページとなった。 - Docker コンテナの port に "5173:5173" を追加し、再度 http://127.0.0.1:5173 へのアクセスを試したところ、異なるエラー ERR_EMPTY_RESPONSE となったもののやはりエラーページとなった。
今回、これを解決しましたのでメモいたします。
まとめ
composer update nunomaduro/larastan:^1.0 --devでアップデートしたところ、 Laravel インストールして生成された無編集のソースコードでエラーが発生した、https://github.com/laravel/laravel/blob/8.x/appから最新ソースコードを適用することで解決したエラーもあった。- どうしても解決できないものは、 Ignoring Errors | PHPStan を参考にエラー抑制した。
対応方法まとめ
- その１
- API リソースクラスの toArray メソッド冒頭に、例えば
/** @var \App\Models\User $this */と書く。 - 要は、 PHPDocs で API リソースクラスで使用するモデルを
$thisに紐づければ良いようだ。
- API リソースクラスの toArray メソッド冒頭に、例えば
- その２
- クラスコメントに、例えば
/** @mixin \App\Models\User */と書く。 - 要は、 PHPDocs で API リソースクラスに使用するモデルを混ぜ込めば良いようだ。
- クラスコメントに、例えば
なぜメモったか
Bootstrap Icons · Bootstrap 向けのオープンソース SVG アイコンライブラリ のページを見ると、インストールと使い方は書いてあるものの、それだけでは足りず、調べなければうまく使うことができませんでした。
ですので、調べた内容を、走り書き程度ですが、メモいたします。
まとめ
- feat: Bootstrap 5 を Laravel 8 の Vue.js 3 SPA に導入する · oki2a24/laravel8-boilerplate@dd592f4 or feat: Bootstrap 5 を Laravel 8 の Vue.js 3 SPA に導入する by oki2a24 · Pull Request #4 · oki2a24/laravel8-boilerplate にやったことが全て残っている。
- npm install したもの
@popperjs/corebootstrapresolve-url-loadersasssass-loader
laravel/webpack.mix.jsに npm build 時の Bootstrap 5 の SASS の設定を追加laravel/resources/js/bootstrap.jsに Bootstrap 5 の読み込を追加laravel/resources/sass/app.scssファイルを追加し、 Bootstrap 5 の SASS を読み込む。laravel/resources/sass/_variables.scssファイルを追加した。 Bootstrap 5 をカスタマイズする時の内容を書くためのファイル
エラー対処まとめ
- 今回の状況
- Laravel 8.55.0
- PHPUnit テストをインメモリ SQLite で行いたい。
DATABASE_URLを外部の環境変数 (server レベル) で設定している。
- テスト用に
DATABASE_URLを指定する以外に、DB_CONNECTIONとDB_DATABASEも指定する必要がある。 - 次のように
phpunit.xmlに指定すればよい。
<server name="DATABASE_URL" value="sqlite:///:memory:?foreign_key_constraints=true" force="true"/>
<server name="DB_CONNECTION" value="sqlite"/>
<server name="DB_DATABASE" value=":memory:"/>
まとめ
- Docker 側のコードは
mailhog/mailhogイメージを使うだけ。 - Laravel 側では、
.envを変更するだけ。
まとめ
- MTA として exim4 (Exim Internet Mailer) を使う。
- exim4 を php:apache コンテナにインストールする。
- PHP からメールを送信できるようになった。
- Laravel から sendmail ドライバーでメールを送信できるようになった。
- 次のページが大いに参考になった (ありがとうございます!) 。