今回、Laravelを本番環境に移した時に起きたこと

まずローカルのLaravelで上手く動いていたのを確認してから本番環境に移すと、移した途端エラーが発生しました。

一言でいうと、原因は全て
ローカルだと寛容に動いてくれるのに本番環境だと厳しくコードを見られて動かない
というのが原因でした。

命名規則のエラー

まず、Laravelのルート\storage\logs\laravel.logを確認すると以下のようなエラーが発生しました。

Class "App\Methods\UserList" not found  
at /app/Http/Controllers/ApiController.php:129

エラーの内容は
App\Methods\UserList クラスが存在しない
つまり、ApiController の中で以下のような処理をしているはずです

use App\Methods\UserList;
...

$userList = new UserList(); // ← ここでクラッシュ！

でも Laravel はその UserList クラスを読み込めない（存在していない or オートロードできない）というエラーです。

次に、以下のコードで実行すると

composer dump-autoload

[XXX123@XXXXXX.com]$ composer dump-autoload
Generating optimized autoload files
Class App\Methods\PrintData located in ./app/Methods/printData.php does not comply with psr-4 autoloading standard. Skipping.
Class App\Methods\UserList located in ./app/Methods/userList.php does not comply with psr-4 autoloading standard. Skipping.
Class App\Models\DeshioKiroku located in ./app/Models/Deshiokiroku.php does not comply with psr-4 autoloading standard. Skipping.
> Illuminate\Foundation\ComposerScripts::postAutoloadDump
> @php artisan package:discover --ansi

   INFO  Discovering packages.  

  anourvalar/eloquent-serialize ............................................. DONE
  blade-ui-kit/blade-heroicons .............................................. DONE
  blade-ui-kit/blade-icons .................................................. DONE
  filament/actions .......................................................... DONE
  filament/filament ......................................................... DONE
  filament/forms ............................................................ DONE
  filament/infolists ........................................................ DONE
  filament/notifications .................................................... DONE
  filament/support .......................................................... DONE
  filament/tables ........................................................... DONE
  filament/widgets .......................................................... DONE
  kirschbaum-development/eloquent-power-joins ............................... DONE
  laravel/pail .............................................................. DONE
  laravel/sail .............................................................. DONE
  laravel/sanctum ........................................................... DONE
  laravel/tinker ............................................................ DONE
  livewire/livewire ......................................................... DONE
  nesbot/carbon ............................................................. DONE
  nunomaduro/collision ...................................................... DONE
  nunomaduro/termwind ....................................................... DONE
  ryangjchandler/blade-capture-directive .................................... DONE
  spatie/laravel-permission ................................................. DONE
  tymon/jwt-auth ............................................................ DONE

> @php artisan filament:upgrade
  ⇂ public/js/filament/forms/components/color-picker.js  
  ⇂ public/js/filament/forms/components/date-time-picker.js  
  ⇂ public/js/filament/forms/components/file-upload.js  
  ⇂ public/js/filament/forms/components/key-value.js  
  ⇂ public/js/filament/forms/components/markdown-editor.js  
  ⇂ public/js/filament/forms/components/rich-editor.js  
  ⇂ public/js/filament/forms/components/select.js  
  ⇂ public/js/filament/forms/components/tags-input.js  
  ⇂ public/js/filament/forms/components/textarea.js  
  ⇂ public/js/filament/tables/components/table.js  
  ⇂ public/js/filament/widgets/components/chart.js  
  ⇂ public/js/filament/widgets/components/stats-overview/stat/chart.js  
  ⇂ public/js/filament/filament/app.js  
  ⇂ public/js/filament/filament/echo.js  
  ⇂ public/js/filament/notifications/notifications.js  
  ⇂ public/js/filament/support/support.js  
  ⇂ public/css/filament/forms/forms.css  
  ⇂ public/css/filament/support/support.css  
  ⇂ public/css/filament/filament/app.css  

   INFO  Successfully published assets!  

   INFO  Configuration cache cleared successfully.  

   INFO  Route cache cleared successfully.  

   INFO  Compiled views cleared successfully.  

   INFO  Successfully upgraded!  

Generated optimized autoload files containing 8082 classes

❌ 問題：PSR-4オートロード規約違反

Class App\Methods\PrintData located in ./app/Methods/printData.php does not comply with psr-4 autoloading standard. Skipping.
Class App\Methods\UserList located in ./app/Methods/userList.php does not comply with psr-4 autoloading standard. Skipping.

つまり、クラス名とファイル名の大文字小文字が一致していないため、Laravel が読み込んでくれないことが原因でした。

実際に保存していたファイル名はuserList.phpとprintData.phpでした。

ローカルのLaravelではそれでも問題なく動くのですがXserverの場合だとそこを厳しく見られたので注意が必要でした。

フィラメントの管理画面が上手く表示されない原因

ローカルのLaravelでは問題なく動くのに本番環境ではログインした後に何も表示されないという現象が起きました。

最初は、ローカルで動かすときと比べて、パスがズレているのだと思い込み、自分では原因を特定出来ませんでした。

ルートの.htacceass

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteRule ^(.*)$ public/$1 [QSA,L]
</IfModule>

ですが、実際は、認証に使っているModelのファイルの記述が古い書き方だったことが原因のようでした。

ルート\app\Models\User.php

User.php

<?php

namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Tymon\JWTAuth\Contracts\JWTSubject;
use Illuminate\Database\Eloquent\Model;

class User extends Authenticatable implements JWTSubject
{
    use Notifiable;

    protected $fillable = ['name', 'login_code', 'password', 'email', 'staff_id', 'is_admin'];

    protected $hidden = ['password'];

    // モデルの作成時にデフォルト値を設定
    protected static function boot()
    {
        parent::boot();

        static::creating(function ($user) {
            // is_adminが設定されていない場合、デフォルトで管理者権限を付与
            if (!isset($user->is_admin)) {
                $user->is_admin = 1;
            }
        });
    }

    // ✅ JWT の識別子を取得
    public function getJWTIdentifier()
    {
        return $this->getKey();
    }

    // ✅ JWT に追加するカスタムクレーム
    public function getJWTCustomClaims()
    {
        return [];
    }

    /**
     * Filament へのアクセス権限を判定するメソッド
     *
     * @return bool
     */
    public function canAccessFilament(): bool
    {
        return $this->is_admin === 1; // `is_admin` が 1 の場合のみ Filament にアクセス可能
    }
}

修正後

User.php

<?php

namespace App\Models;

use Filament\Panel;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Filament\Models\Contracts\FilamentUser;
use Tymon\JWTAuth\Contracts\JWTSubject;
use Illuminate\Database\Eloquent\Model;

class User extends Authenticatable implements JWTSubject, FilamentUser
{
    use Notifiable;

    // laravel_db接続を指定
    protected $connection = 'mysql';

    protected $fillable = ['name', 'login_code', 'password', 'email', 'staff_id', 'is_admin'];

    protected $hidden = ['password'];

    // モデルの作成時にデフォルト値を設定
    protected static function boot()
    {
        parent::boot();

        static::creating(function ($user) {
            // is_adminが設定されていない場合、デフォルトで管理者権限を付与
            if (!isset($user->is_admin)) {
                $user->is_admin = 1;
            }
        });
    }

    // ✅ JWT の識別子を取得
    public function getJWTIdentifier()
    {
        return $this->getKey();
    }

    // ✅ JWT に追加するカスタムクレーム
    public function getJWTCustomClaims()
    {
        return [];
    }

    /**
     * Filament へのアクセス権限を判定するメソッド
     *
     * @return bool
     */
    public function canAccessPanel(Panel $panel): bool
    {
       return $this->is_admin === 1; // `is_admin` が 1 の場合のみ Filament にアクセス可能

    }
}

✅ 主な変更点の解説

① FilamentUser インターフェースの追加

use Filament\Models\Contracts\FilamentUser;

目的：
Filament v3 以降では、ユーザーモデルが管理画面（Filament）にアクセスできるかを判定するために、FilamentUser インターフェースの実装が必要になりました。

② canAccessFilament() → canAccessPanel(Panel $panel) へ変更

変更前：

public function canAccessFilament(): bool

変更後

public function canAccessPanel(Panel $panel): bool

変更理由：
Filament の仕様変更により、ユーザーがアクセスできる「パネル（Panel）」が複数存在することを想定した構成に変わったため、どの Panel にアクセスするかを引数として受け取る必要が出てきました。

③ protected $connection = 'mysql'; の追加

protected $connection = 'mysql';

目的：
Laravel では、デフォルト以外のデータベース接続をモデル単位で指定することができます。
今回はデフォルトのデータベース以外にもう一つのデータベースとの連携をUsersテーブルにさせるために
デフォルトのデータベースのUserテーブルを使うことを
User モデルに対して mysql 接続を明示的に指定しています
（laravel_db がデフォルトのデータベース）

④protected $connection = 'mysql';の `mysql`はどこで設定した文字列なのか

ルート\config\database.php に記述した設定を使用しています。

database.php

<?php

use Illuminate\Support\Str;

return [


    'default' => env('DB_CONNECTION', 'mysql'),


    'connections' => [

        'sqlite' => [
            'driver' => 'sqlite',
            'url' => env('DB_URL'),
            'database' => env('DB_DATABASE', database_path('database.sqlite')),
            'prefix' => '',
            'foreign_key_constraints' => env('DB_FOREIGN_KEYS', true),
            'busy_timeout' => null,
            'journal_mode' => null,
            'synchronous' => null,
        ],

        // ✅ デフォルトの MySQL 接続（LaravelのメインDB）
        'mysql' => [
            'driver' => 'mysql',
            'host' => env('XXXXXXX', '127.0.0.1'),
            'port' => env('XXXXXXX', '3306'),
            'database' => env('XXXXX_DB_DATABASE', 'XXXXXXX'),
            'username' => env('XXXXX_DB_USERNAME', 'XXXX'),
            'password' => env('XXXX_DB_PASSWORD', 'XXXX'),
            'charset' => env('XXXXX_DB_CHARSET', 'utf8mb4'),
            'collation' => env('XXXXXX_DB_COLLATION', 'utf8mb4_unicode_ci'),
            'prefix' => '',
            'strict' => true,
            'engine' => null,
        ],
            // ✅ もう一つのMySQL 接続（外部のデータベース）
        'XXXXXXXX' => [
            'driver' => 'mysql',
            'host' => env('XXXXXXX', '127.0.0.1'),
            'port' => env('XXXXXXX', '3306'),
            'database' => env('XXXXX_DB_DATABASE', 'XXXXXXX'),
            'username' => env('XXXXX_DB_USERNAME', 'XXXX'),
            'password' => env('XXXX_DB_PASSWORD', 'XXXX'),
            'charset' => env('XXXXX_DB_CHARSET', 'utf8mb4'),
            'collation' => env('XXXXXX_DB_COLLATION', 'utf8mb4_unicode_ci'),
            'prefix' => '',
            'strict' => true,
            'engine' => null,
        ],

        'mariadb' => [
            'driver' => 'mariadb',
            'url' => env('DB_URL'),
            'host' => env('DB_HOST', '127.0.0.1'),
            'port' => env('DB_PORT', '3306'),
            'database' => env('DB_DATABASE', 'laravel'),
            'username' => env('DB_USERNAME', 'root'),
            'password' => env('DB_PASSWORD', ''),
            'unix_socket' => env('DB_SOCKET', ''),
            'charset' => env('DB_CHARSET', 'utf8mb4'),
            'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'),
            'prefix' => '',
            'prefix_indexes' => true,
            'strict' => true,
            'engine' => null,
            'options' => extension_loaded('pdo_mysql') ? array_filter([
                PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
            ]) : [],
        ],

        'pgsql' => [
            'driver' => 'pgsql',
            'url' => env('DB_URL'),
            'host' => env('DB_HOST', '127.0.0.1'),
            'port' => env('DB_PORT', '5432'),
            'database' => env('DB_DATABASE', 'laravel'),
            'username' => env('DB_USERNAME', 'root'),
            'password' => env('DB_PASSWORD', ''),
            'charset' => env('DB_CHARSET', 'utf8'),
            'prefix' => '',
            'prefix_indexes' => true,
            'search_path' => 'public',
            'sslmode' => 'prefer',
        ],

        'sqlsrv' => [
            'driver' => 'sqlsrv',
            'url' => env('DB_URL'),
            'host' => env('DB_HOST', 'localhost'),
            'port' => env('DB_PORT', '1433'),
            'database' => env('DB_DATABASE', 'laravel'),
            'username' => env('DB_USERNAME', 'root'),
            'password' => env('DB_PASSWORD', ''),
            'charset' => env('DB_CHARSET', 'utf8'),
            'prefix' => '',
            'prefix_indexes' => true,
            // 'encrypt' => env('DB_ENCRYPT', 'yes'),
            // 'trust_server_certificate' => env('DB_TRUST_SERVER_CERTIFICATE', 'false'),
        ],

    ],

    /*
    |--------------------------------------------------------------------------
    | Migration Repository Table
    |--------------------------------------------------------------------------
    |
    | This table keeps track of all the migrations that have already run for
    | your application. Using this information, we can determine which of
    | the migrations on disk haven't actually been run on the database.
    |
    */

    'migrations' => [
        'table' => 'migrations',
        'update_date_on_publish' => true,
    ],

    /*
    |--------------------------------------------------------------------------
    | Redis Databases
    |--------------------------------------------------------------------------
    |
    | Redis is an open source, fast, and advanced key-value store that also
    | provides a richer body of commands than a typical key-value system
    | such as Memcached. You may define your connection settings here.
    |
    */

    'redis' => [

        'client' => env('REDIS_CLIENT', 'phpredis'),

        'options' => [
            'cluster' => env('REDIS_CLUSTER', 'redis'),
            'prefix' => env('REDIS_PREFIX', Str::slug(env('APP_NAME', 'laravel'), '_').'_database_'),
        ],

        'default' => [
            'url' => env('REDIS_URL'),
            'host' => env('REDIS_HOST', '127.0.0.1'),
            'username' => env('REDIS_USERNAME'),
            'password' => env('REDIS_PASSWORD'),
            'port' => env('REDIS_PORT', '6379'),
            'database' => env('REDIS_DB', '0'),
        ],

        'cache' => [
            'url' => env('REDIS_URL'),
            'host' => env('REDIS_HOST', '127.0.0.1'),
            'username' => env('REDIS_USERNAME'),
            'password' => env('REDIS_PASSWORD'),
            'port' => env('REDIS_PORT', '6379'),
            'database' => env('REDIS_CACHE_DB', '1'),
        ],

    ],

];

下記の 'mysql'が先ほどの Model/User.php で指定した文字列になります。(デフォルトのデータベースはmysqlに初期状態はなっている)

        'mysql' => [
            'driver' => 'mysql',
            .....

別の ✅ もう一つのMySQL 接続（外部のデータベース）をしたい場合は XXXXXXXX' => [の XXXXXXXXを使用します。

外部のデータベース使用例

Staff.php

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Factories\HasFactory;
class StaffLaravelLink extends Model
{
    use HasFactory;
    // 'XXXXXXXX' という接続先を利用
    protected $connection = 'XXXXXXXX';

    protected $table = 'staff';

`'host' => env('XXXXXXX', '127.0.0.1'),` の記述の意味

これは.envファイルのキーがなければ右のデフォルト値を使用するという意味です

env('キー名', 'デフォルト値')

🛠 その他は同じ内容（JWT関連、fillableなど）

以下の記述は、旧コードと変更なしです：

getJWTIdentifier() と getJWTCustomClaims() → JWT認証に必要な定義

$fillable, $hidden → Eloquentモデルの基本

boot() 内の creating() → モデル作成時に is_admin にデフォルト値を設定する処理

🎯 まとめ

変更点理由・背景
FilamentUser 実装 Filament v3 対応のため必要
canAccessFilament() → canAccessPanel(Panel $panel) マルチパネル対応の新仕様
$connection = 'mysql' データベース接続を明示的に指定
このように、LaravelやFilamentのアップデートに伴って、モデルの書き方も少しずつ変わっていきます。特に認証や管理画面に関する部分はバージョン依存が強いので、ドキュメントやリリースノートをこまめに確認するのが大切です。

参考：Filament v3 ドキュメント