Command panel:user

Command:

php artisan panel:user

membuat account yang dapat digunakan untuk login ke Panel menggunakan User Model dari auth guard yang dipilih.

Setelah account dibuat, command juga melaporkan apakah account tersebut benar-benar diizinkan memasuki Panel.

Command ini sangat berguna pada:

• fresh installation;
• initial administrator setup;
• provisioning script;
• environment yang sudah memiliki Panel tetapi belum memiliki user.

Contoh Minimal

php artisan panel:user

Interactive prompt:

 Name:
 > Ada Lovelace

 Email address:
 > ada@example.com

 Password:
 > ********

 INFO  Created Ada Lovelace <ada@example.com>.

 INFO  They can sign into the Administrator panel at admin.

Semua value juga dapat diberikan melalui option:

php artisan panel:user \
    --name=Ada \
    --email=ada@example.com \
    --password=correct-horse-battery

Signature

panel:user
    {--name= : The account name}
    {--email= : The email address to sign in with}
    {--password= : The password, prompted for when omitted}
    {--guard= : The auth guard whose user model to create, defaults to the application default}
    {--panel= : Report whether the new account can reach this panel}

Option	Default	Validation
--name	prompt	required, string, max:255
--email	prompt	required, string, email, max:255
--password	hidden prompt	required, string, min:8
--guard	auth.defaults.guard	Harus menunjuk guard yang memiliki provider
--panel	Panel pertama yang diregistrasikan	Hanya digunakan untuk report

Exit code:

0

jika sukses.

1

jika validation, guard, atau model gagal.

Handler:

public function handle(
    PandaPanel\Core\PanelManager $manager
): int;

Password validation sengaja tidak menggunakan:

Password::defaults()

Command ini dijalankan oleh operator yang memiliki database access, bukan public registration.

Registration form tetap menggunakan password policy application.

Model yang Dibuat

Command tidak hard-code:

App\Models\User

Model ditentukan melalui auth config:

--guard
atau
auth.defaults.guard
       ↓
auth.guards.{guard}.provider
       ↓
auth.providers.{provider}.model

Contoh:

php artisan panel:user \
    --guard=admin \
    --panel=admin

Jika guard admin menggunakan:

App\Models\Admin

maka model tersebut yang dibuat.

Ini mencegah command membuat record di table yang salah.

Failure Guard/Provider

Dua kemungkinan error utama:

Pesan	Penyebab
No auth guard named [x].	Guard tidak tersedia/tidak memiliki provider valid
The [users] user provider names no model this command can create.	Provider tidak memiliki model class yang dapat dibuat

Keduanya exit dengan code:

1

Data yang Ditulis

$user =
    new $model;

$user->forceFill([
    'name' =>
        $attributes['name'],

    'email' =>
        $attributes['email'],

    'password' =>
        Hash::make(
            $attributes['password']
        ),

    'email_verified_at' =>
        now(),
])->save();

forceFill() digunakan karena command tidak mengetahui $fillable milik host application.

Hash::make() digunakan secara eksplisit agar command tidak bergantung pada hashed cast.

email_verified_at langsung diisi karena account console dianggap sudah diverifikasi oleh operator yang menjalankan command.

Jika dibiarkan null, initial administrator dapat langsung tertahan oleh:

verified middleware

Jika database menolak insert, misalnya:

• unique email;
• extra NOT NULL column;

exception ditangkap dan database message ditampilkan:

ERROR  The user could not be created: SQLSTATE[23000]...

Access Report

Setelah account berhasil dibuat:

$panel
    ->isAccessibleTo(
        $user
    );

dipanggil.

Dua rule harus sama-sama mengizinkan:

Panel::canAccess()
+
PanelUser::canAccessPanel()

Output sukses:

INFO  They can sign into the Administrator panel at admin.

Jika Panel rule menolak:

WARN  They cannot reach the Administrator panel yet —
      the panel's own canAccess() says no.

Jika User Model menolak:

WARN  They cannot reach the Administrator panel yet —
      your user model's canAccessPanel() says no.

Command hanya melaporkan, bukan membatalkan pembuatan account.

Account yang belum memiliki:

is_admin = true

misalnya masih merupakan valid intermediate state.

Promosi dapat dilakukan eksplisit:

use App\Models\User;

User::query()
    ->where(
        'email',
        'ada@example.com'
    )
    ->firstOrFail()
    ->forceFill([
        'is_admin' => true,
    ])
    ->save();

Panel yang Diperiksa

php artisan panel:user --panel=admin

Tanpa --panel, command menggunakan Panel pertama yang diregistrasikan berdasarkan urutan:

config(
    'panda-panel.panels'
)

Panel id biasanya berasal dari provider basename:

AdminPanelProvider
→ admin

CustomerPortalPanelProvider
→ customer-portal

kecuali provider menentukan id secara eksplisit.

Perlu diperhatikan: --panel yang salah saat ini tidak menghasilkan error.

Contoh:

--panel=admn

account tetap dibuat, tetapi tidak ada access report.

Application tanpa Panel terdaftar juga memiliki behavior serupa.

Non-Interactive Run

Jika tidak ada interactive terminal, command tidak menunggu prompt.

Missing input menjadi empty string kemudian validation menjelaskan option yang hilang.

php artisan panel:user --no-interaction

Output:

ERROR  The name field is required.
ERROR  The email field is required.
ERROR  The password field is required.

Provisioning/CI harus memberikan semua required values:

php artisan panel:user \
  --name="$ADMIN_NAME" \
  --email="$ADMIN_EMAIL" \
  --password="$ADMIN_PASSWORD" \
  --panel=admin \
  --no-interaction

Interactive mode menggunakan Laravel Prompts.

Password prompt tidak di-echo.

Hubungan dengan panel:install

Pada akhir:

php artisan panel:install

installer dapat menawarkan pembuatan initial user.

Installer pada akhirnya memanggil command yang sama dengan:

--panel={panel}

Jadi menjalankan:

php artisan panel:user --panel=admin

secara manual setelah instalasi menghasilkan behavior yang sama.

Testing

it(
    'creates a user through the guard own model',
    function (): void {
        $this
            ->artisan(
                'panel:user',
                [
                    '--name' =>
                        'Ada Lovelace',

                    '--email' =>
                        'ada@example.com',

                    '--password' =>
                        'correct-horse-battery',

                    '--panel' =>
                        'admin',
                ]
            )
            ->assertSuccessful();

        expect(
            User::query()
                ->where(
                    'email',
                    'ada@example.com'
                )
                ->exists()
        )->toBeTrue();
    }
);

Unknown guard:

$this
    ->artisan(
        'panel:user',
        [
            '--guard' =>
                'nope',
        ]
    )
    ->assertFailed();

Hal yang Perlu Diperhatikan

• --password= dapat masuk shell history dan process list. Gunakan hidden prompt atau environment variable pada shared machine.
• Command hanya create, tidak update.
• Tidak ada --force untuk overwrite existing user.
• Access report bukan authorization gate saat create.
• Typo --panel tidak menghasilkan error/report.
• Hanya empat attribute yang ditulis.
• Extra NOT NULL column tanpa default dapat membuat save gagal.
• Panel canAccess() dipanggil dari console, sehingga callback jangan bergantung pada request()->route().

Lihat Juga

• Creating the First User
• CLI panel:user
• The PanelUser Contract
• User Model Requirements
• Panel Access Rules
• Installer
• Login
• Email Verification