Cara Membaiki Masalah Autoloading PSR-4 dalam Laravel

ByTukang Post

Apabila bekerja pada projek Laravel, anda mungkin menghadapi amaran apabila menjalankan composer dump-autoload. Amaran ini sering menunjukkan bahawa nama fail model atau controller anda tidak sepadan dengan namespace atau nama class mereka.

Baru-baru ini, semasa bekerja pada projek Laravel, saya menghadapi isu autoloading yang melibatkan MenuItem, KitchenSection, dan MenuCategoryController. Membaiki isu-isu tersebut membantu saya memahami cara autoloading Composer berfungsi dan mengapa konvensyen penamaan yang konsisten penting dalam Laravel.

Dalam artikel ini, saya akan menjelaskan cara mengenal pasti dan menyelesaikan isu-isu tersebut.

1. Apakah PSR-4 Autoloading?

PSR-4 ialah piawaian PHP yang menentukan bagaimana namespace dipetakan kepada struktur direktori dan nama fail.

Dalam aplikasi Laravel yang tipikal, namespace:

namespace App\Models;

dipetakan kepada direktori app/Models/.

Sebagai contoh, model bernama MenuItem biasanya perlu terletak di:

app/
└── Models/
    └── MenuItem.php

Dalam MenuItem.php, class perlu diisytiharkan sebagai:


namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class MenuItem extends Model
{
    //
}

Namespace, nama fail, dan nama class perlu mengikut konvensyen penamaan yang dijangkakan.

2. Kenal pasti Amaran Autoloading

Apabila menjalankan:

composer dump-autoload

anda mungkin melihat amaran seperti:

Class App\Models\MenuItem located in
./app/Models/MenuItems.php does not comply with
psr-4 autoloading standard. Skipping.

Masalahnya ialah class tersebut bernama MenuItem, tetapi failnya bernama MenuItems.php.

Nama tunggal dan nama jamak tidak sepadan.

Contoh biasa lain ialah:

Class App\models\KitchenSection

Namespace menggunakan models dengan huruf kecil m, sedangkan namespace mengikut konvensyen Laravel ialah App\Models.

Sistem fail Linux juga peka huruf besar/kecil, jadi perbezaan penggunaan huruf besar boleh menyebabkan masalah.

3. Baiki Nama Fail Model

Pertama, pergi ke root projek Laravel anda:

cd ~/Desktop/Development/samupos

Periksa sama ada fail model wujud:

ls -l app/Models/MenuItems.php app/Models/MenuItem.php

Jika MenuItems.php wujud dan MenuItem.php tidak wujud, tukar nama fail:

mv app/Models/MenuItems.php app/Models/MenuItem.php

Sahkan namespace dan pengisytiharan class:

grep -nE 'namespace|class MenuItem' app/Models/MenuItem.php

Output yang dijangkakan sepatutnya menunjukkan:

namespace App\Models;

class MenuItem extends Model

Nombor baris yang tepat mungkin berbeza.

Penting: Jika kedua-dua nama fail wujud, periksa kedua-duanya sebelum menukar nama atau memadam apa-apa. Anda tidak mahu menimpa atau kehilangan kod model.

4. Betulkan Namespace

Buka model KitchenSection:

nano app/Models/KitchenSection.php

Jika fail tersebut mengandungi:

namespace App\models;

tukarkan kepada:

namespace App\Models;

Simpan fail tersebut dan sahkan perubahan:

grep -nE 'namespace|class KitchenSection' app/Models/KitchenSection.php

Namespace sepatutnya:

namespace App\Models;

Pengisytiharan class sepatutnya:

class KitchenSection extends Model

Ingat bahawa nama class, nama fail, dan namespace mesti selari dengan struktur autoloading yang dijangkakan.

5. Baiki Penggunaan Huruf Besar pada Direktori Controller

Isu yang sama boleh menjejaskan controller.

Sebagai contoh, pengawal yang menggunakan ruang nama ini:

namespace App\Http\Controllers\Api;

biasanya terletak di:

app/Http/Controllers/Api/MenuCategoryController.php

Jika direktori dinamakan API dan bukannya Api , penggunaan huruf besar/kecil boleh menyebabkan amaran PSR-4 pada sistem fail peka huruf besar/kecil.

Sebelum menamakan semula direktori, periksa struktur sedia ada:

find app/Http/Controllers -maxdepth 2 -type f

Pastikan nama direktori sepadan dengan ruang nama dan anda belum mempunyai direktori konflik dengan penggunaan huruf besar/kecil yang berbeza.

6. Jana Semula Fail Autoload Composer

Selepas membetulkan nama fail, ruang nama, dan struktur direktori, jana semula autoloader:

composer dump-autoload

Composer mengimbas pemetaan kelas yang dikonfigurasi dan menjana fail autoload yang dikemas kini.

Keputusan yang berjaya mungkin kelihatan seperti:

Generating optimized autoload files
> Illuminate\Foundation\ComposerScripts::postAutoloadDump
> @php artisan package:discover --ansi

Generated optimized autoload files containing 9788 classes

Bilangan kelas akan berbeza-beza mengikut projek.

Jika perintah selesai tanpa amaran PSR-4, isu penamaan yang dilaporkan kemungkinan besar telah diselesaikan.

7. Kosongkan Konfigurasi Cache Laravel

Seterusnya, jalankan:

php artisan optimize:clear

Perintah ini mengosongkan fail pengoptimuman cache Laravel, termasuk konfigurasi cache dan laluan cache.

Perhatikan bahawa perintah ini tidak membaiki ruang nama atau nama fail yang salah. Kedua-duanya mesti diperbaiki terlebih dahulu.

8. Sahkan Bahawa Laravel Boleh Memuatkan Model

Laravel Tinker menyediakan shell PHP interaktif yang anda boleh gunakan untuk menguji sama ada kelas boleh dimuatkan.

Mulakan Tinker:

php artisan tinker

Periksa model MenuItem:

class_exists(\App\Models\MenuItem::class);

Kemudian periksa KitchenSection :

class_exists(\App\Models\KitchenSection::class);

Jika kedua-dua ungkapan mengembalikan:

true

PHP boleh memuatkan kedua-dua kelas menggunakan nama berkelayakan penuh masing-masing.

Keluar daripada Tinker:

exit

Ingat bahawa class_exists() mengesahkan pemuatan kelas, bukan sama ada jadual pangkalan data, hubungan, atau migrasi adalah betul.

9. Kesilapan Lazim yang Perlu Dielakkan

Berikut ialah beberapa pengajaran daripada proses penyelesaian masalah ini:

  • Ketidakpadanan nama fail: MenuItems.php dan MenuItem.php ialah nama fail yang berbeza.
  • Penggunaan huruf besar/kecil ruang nama yang salah: App\models dan App\Models tidak boleh dianggap boleh ditukar ganti pada sistem peka huruf besar/kecil.
  • Direktori kerja yang salah: Jalankan perintah Artisan dan Composer dari akar projek Laravel, tempat artisan dan composer.json berada.
  • Menjalankan perintah bersama secara tidak betul: Laksanakan perintah secara berasingan, atau gabungkannya secara eksplisit dengan && . Sebagai contoh:
cd ~/Desktop/Development/samupos && composer dump-autoload
  • Mengandaikan pengosongan cache membaiki segala-galanya: optimize:clear tidak dapat membetulkan pengisytiharan kelas atau ketidakpadanan nama fail.
  • Mengabaikan amaran: Composer mungkin selesai dengan jayanya sambil masih melangkau kelas yang tidak mematuhi PSR-4.

Kesimpulan

Menyelesaikan isu autoloading Laravel biasanya bergantung kepada konsistensi: nama fail, nama kelas, ruang nama, dan struktur direktori mesti sepadan.

Aliran kerja pemecahan masalah saya mudah:

  1. Baca amaran Composer yang tepat.
  2. Periksa laluan fail, ruang nama, dan nama kelas.
  3. Betulkan ketidakpadanan.
  4. Jalankan composer dump-autoload.
  5. Jalankan php artisan optimize:clear.
  6. Sahkan pemuatan kelas dengan Tinker.

Langkah-langkah ini membantu menjadikan projek Laravel lebih boleh dipercayai dan lebih mudah diselenggara, terutamanya apabila bekerja dengan model dan pengawal API dalam aplikasi yang berkembang.

Adakah anda pernah menemui amaran autoloading PSR-4 dalam Laravel? Kongsi apa yang menyebabkan amaran anda dan bagaimana anda menyelesaikannya dalam ruangan komen.

Sumber Rujukan:

  • Artikel asal: Dev.to PHP
  • Diterjemah daripada artikel asal ke Bahasa Melayu oleh AI Editorial – haqis.com
Comments

Similar Posts