TypeError vendor\filament\filament\src\FilamentManager.php:586 Filament\FilamentManager::getUserName(): Return value must be of type string, null returned

[sajjadef98]

Package

Panel builder

Package Version

v4.0

How can we help you?

TypeError vendor\filament\filament\src\FilamentManager.php:586 
Filament\FilamentManager::getUserName(): 
Return value must be of type string, null returned

laravel12, php8.3 , filament v4

After a day of problems with the dedicated panel and using the password login via SMS, I solved the problem today. I will write the solution so that others can use it too.
my users

 public function up(): void
    {
        Schema::create('users', function (Blueprint $table) {
        
            $table->id();

           
            $table->string('username')->unique();

       
            $table->string('mobile')->unique();

            $table->unsignedBigInteger('province_id')->nullable();
            $table->unsignedBigInteger('city_id')->nullable();

          
            $table->timestamp('last_seen_at')->nullable();

            
            $table->rememberToken();

           
            $table->timestamps();
        });
    }

Solution

<?php

namespace App\Models;

use Filament\Models\Contracts\FilamentUser;
use Filament\Panel;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;

class User extends Authenticatable implements FilamentUser
{
    use HasFactory, Notifiable;
    protected $appends = ['name'];

    public function getNameAttribute(): string
    {
        return $this->username ?? $this->mobile ?? 'user';
    }
    protected $fillable = [
        'username',
        'mobile',
        'province_id',
        'city_id',
        'last_seen_at',
    ];

    protected $hidden = [
        'remember_token',
    ];


    public function canAccessPanel(Panel $panel): bool
    {
     
        return in_array($this->mobile, [
            '09**********9',
            '09**********9',
        ]);
    }

    public function getFilamentName(): string
    {
        $name = $this->username ?? $this->mobile ?? null;
        if (is_null($name) || trim($name) === '') {
            return 'user';
        }
        return (string) $name;
    }



}

Just add this to your model.

    protected $appends = ['name'];

    public function getNameAttribute(): string
    {
        return $this->username ?? $this->mobile ?? 'user';
    }