Panduan muat naik fail laravel: Mengendalikan storan imej dengan betul dan soalan yang sering ditanya

Tutorial ini memberikan panduan terperinci tentang cara melaksanakan fungsi muat naik imej tempatan dengan betul dalam aplikasi Laravel, yang memberi tumpuan kepada menyelesaikan kesilapan null yang dihadapi semasa menggunakan getClientOriginAxtension (). Artikel ini akan menerangkan perbezaan antara permintaan-> fail () dan permintaan-> input (), dan memberikan contoh kod lengkap dan amalan terbaik untuk menyimpan imej dalam direktori awam atau penyimpanan/aplikasinya menggunakan kaedah Move () dan StoreAs () untuk memastikan proses muat naik fail yang lancar dan selamat.

Dalam pembangunan Laravel, muat naik fail adalah keperluan biasa, tetapi pemula sering menghadapi kesilapan seperti panggilan ke fungsi ahli getClientOriginExtension () pada null. Kesalahan ini biasanya berlaku apabila cuba mendapatkan kaedah yang tidak wujud atau tidak diiktiraf dengan betul. Artikel ini akan menggali jauh ke dalam punca masalah ini dan memberikan penyelesaian yang tepat dan amalan terbaik.

Memahami getClientOriginAxtension () atas kesilapan null

Apabila anda cuba menggunakan $ permintaan-> input ('imej') dalam pengawal untuk mendapatkan fail yang dimuat naik, kaedah input laravel () digunakan untuk mendapatkan nilai medan input teks borang. Untuk memuat naik fail, Laravel merangkumi data fail ke dalam objek yang dimuat naik dan mengaksesnya melalui kaedah $ permintaan-> fail ().

Jika anda menggunakan $ permintaan-> input ('imej'), ia boleh mengembalikan null apabila fail tidak dimuat naik atau gagal dimuat naik. Walaupun fail itu dimuat naik dengan jayanya, kaedah input () hanya akan mengembalikan nama rentetan fail, bukan contoh yang dimuat naik. Oleh itu, apabila anda cuba memanggil kaedah yang khusus untuk objek yang dimuat naik seperti getClientOriginAxtension () pada nilai null atau rentetan, ralat getClientOriginExtension () pada null dibuang.

Mata Utama:

• $ permintaan-> input ('field_name') : Digunakan untuk mendapatkan nilai medan borang normal (teks, nombor, dll.).
• $ request-> file ('field_name') : Digunakan untuk mendapatkan contoh fail yang dimuat naik dan mengembalikan objek Illuminate \ http \ uploadedFile.

Kaedah muat naik fail laravel

Kunci untuk mengendalikan muat naik fail dengan betul adalah menggunakan kaedah $ permintaan-> fail () untuk mendapatkan contoh yang dimuat naik, dan kemudian gunakan pelbagai kaedah yang disediakan oleh contoh untuk menyimpan fail.

1. Pastikan borang ditetapkan dengan betul

Pertama, pastikan borang HTML anda mengandungi atribut Enctype = "Multipart/Form-Data", yang diperlukan untuk memuat naik fail.

@csrf

Nama pengguna

@if ($ errors-> mempunyai ('nama pengguna')) {{$ errors-> first ('username')}} @endif

Gambar profil

Daftar

2. Proses fail dalam pengawal

Dalam pengawal, kita perlu menyemak sama ada terdapat fail yang dimuat naik terlebih dahulu, kemudian dapatkan contoh fail dan simpannya.

Contoh kod pengawal:

  Php

App Namespace \ http \ controllers;

Gunakan Illuminate \ http \ request;
Gunakan App \ Models \ Post; // Katakan anda mempunyai model pos untuk menyimpan kelas maklumat imej imageuploadcontroller memanjangkan pengawal
{
    /**
     * Proses muat naik dan simpan imej secara tempatan.
     *
     * @param \ Illuminate \ http \ permintaan $ permintaan
     * @param int | null $ postid jika anda perlu mengemas kini rekod sedia ada, lulus postid
     * @return \ Illuminate \ http \ response
     */
    Fungsi awam UploadImage (permintaan $ permintaan, $ postid = null)
    {
        // 1. Pengesahan Dokumen (sangat disyorkan)
        $ permintaan-> validate ([
            'image' => 'diperlukan | imej | mimes: jpeg, png, jpg, gif, svg | max: 2048', // peraturan pengesahan sampel]);

        // 2. Semak jika terdapat sebarang fail muat naik jika (! $ Request-> hasFile ('image')) {
            // Jika tiada fail, anda boleh mengembalikan ralat atau melakukan pemprosesan lain. Kembali kembali ()-> WithErrors ('Sila pilih fail imej untuk memuat naik.');
        }

        // 3. Dapatkan contoh yang dimuat naik // nota: gunakan fail () bukan input () di sini
        $ file = $ request-> file ('image');

        // 4. Dapatkan lanjutan fail $ lanjutan = $ file-> getClientOriginAxtension ();

        // 5. Menjana nama fail yang unik untuk mengelakkan penindasan fail.
        // nota: `masa (). ','.
        $ filename = time (). '.' . $ lanjutan;

        // 6. Simpan fail ke lokasi yang berbeza // Kaedah 1: Gunakan kaedah langkah () untuk menyimpannya dalam direktori awam // Fail akan disimpan terus dalam direktori awam/imej dan boleh diakses secara langsung melalui url // Nota: parameter 'imej' adalah laluan $ file-> bergerak (awam_path ('imej'), $ filename);
        $ publicPath = 'image/'. $ fileName; // Laluan yang digunakan untuk Penyimpanan Pangkalan Data // Kaedah 2: Gunakan kaedah StoreAs () untuk menyimpannya dalam Storan/App/Direktori Awam // Kaedah ini lebih disyorkan. Fail ini akan disimpan dalam Direktori Penyimpanan/App/Awam/Imej // Kaedah ini memerlukan menjalankan `PHP Artisan Storage: Link` untuk membuat pautan simbolik untuk mengaksesnya melalui url // $ storagePath = $ file-> storeAs ('awam/imej', $ fail); // Laluan relatif kepada penyimpanan/app // 7. Simpan nama fail ke pangkalan data $ post = $ postid? POST :: Cari ($ postid): Pos baru ();
        jika (! $ post) {
            kembali kembali ()-> withErrors ('pos tidak wujud.');
        }
        $ post-> image = $ publicPath; // atau $ penyimpanan
        $ post-> tajuk = $ permintaan-> input ('tajuk', 'tajuk lalai'); // Contoh: Simpan medan lain $ post-> simpan ();

        kembali kembali ()-> dengan ('kejayaan', 'imej dimuat naik dengan jayanya!');
    }
}

Penjelasan terperinci mengenai kaedah penyimpanan

• $ file-> move (public_path ('your_folder'), $ filename);

  • Kaedah ini akan memindahkan fail yang dimuat naik terus ke folder yang ditentukan dalam direktori awam.
  • Sebagai contoh, public_path ('imej') akan memindahkan fail ke direktori anda
  • Kelebihan: Mudah dan langsung, selepas memuat naik fail, anda boleh mengaksesnya melalui anda_domain.com/image/filename.ext.
  • Kekurangan: Pengubahsuaian langsung direktori awam mungkin tidak mematuhi dasar penempatan tertentu dan tidak kondusif untuk memfailkan pengurusan kebenaran.

• $ file-> storeAs ('public/your_folder', $ filename);

  • Kaedah ini menyimpan fail yang dimuat naik ke folder yang ditentukan dalam storan/aplikasi/direktori awam.
  • Sebagai contoh, 'awam/imej' akan menyimpan fail dalam direktori anda dalam direktori anda
  • kelebihan:
    • Pisahkan fail yang dimuat naik oleh pengguna dari kod aplikasi untuk meningkatkan keselamatan.
    • Mudah untuk menggunakan konfigurasi sistem fail Laravel (contohnya, beralih ke storan awan seperti S3).
    • Melalui Penyimpanan Artisan PHP: Perintah Pautan, anda boleh membuat pautan simbolik awam/penyimpanan yang menunjuk kepada penyimpanan/aplikasi/awam dalam direktori awam, dengan itu membolehkan akses kepada fail -fail ini melalui URL.
  • Kelemahan: Perlu melaksanakan storan: Link Command Extra.

Amalan dan langkah berjaga -jaga terbaik

1. Pengesahan Fail : Sebelum memproses muat naik fail, pastikan anda melakukan pengesahan yang ketat. Laravel menyediakan peraturan pengesahan yang kuat seperti imej (pastikan ia adalah fail imej), mimes (jenis fail had), maksimum (saiz fail had), dan lain -lain. Ini dapat dengan berkesan menghalang muat naik fail berniat jahat dan penyalahgunaan sumber pelayan.

    $ permintaan-> validate ([
       'Image' => 'Diperlukan | Imej | Mimes: JPEG, PNG, JPG, GIF, SVG | MAX: 2048', // 2MB
   ]);

2. Menjana nama fail yang unik : Elakkan menggunakan nama fail asal yang dimuat naik oleh pengguna, kerana mungkin terdapat penindasan fail atau risiko keselamatan. Gunakan masa (), uniqid (), atau str :: rawak () untuk menggabungkan sambungan fail untuk menghasilkan nama fail yang unik.

3. Nama fail penyimpanan pangkalan data : Biasanya, anda akan menyimpan laluan atau nama fail fail yang dimuat naik dalam pangkalan data untuk mendapatkan semula dan paparan jika diperlukan. Hanya simpan nama fail atau laluan berbanding dengan laluan asas.

4. PHP Artisan Penyimpanan: Pautan : Jika anda memilih untuk menyimpan fail dalam storan/aplikasinya/direktori awam, pastikan anda menjalankan perintah ini semasa penempatan untuk membuat pautan simbolik dari awam/penyimpanan ke penyimpanan/aplikasi/awam supaya fail -fail ini dapat diakses melalui URL awam.

5. Pengendalian ralat : Semasa proses muat naik fail, pelbagai kesilapan mungkin ditemui (seperti fail yang terlalu besar, jenis yang tidak konsisten, ruang cakera yang tidak mencukupi, dan lain -lain). Pastikan kod pengawal anda mengendalikan kesilapan ini dengan betul dan memberi pengguna maklum balas yang mesra.

6. Padam fail lama : Jika ia adalah operasi kemas kini dan pengguna memuat naik gambar baru, ingat untuk memadam fail gambar lama untuk mengelakkan membuang ruang penyimpanan pelayan.

Dengan mengikuti garis panduan dan amalan terbaik di atas, anda boleh melaksanakan muat naik fail dengan selamat dan cekap dalam aplikasi Laravel anda, elakkan getClientOriginExtension () biasa pada kesilapan null, dan membina sistem pengurusan fail yang mantap.

Atas ialah kandungan terperinci Panduan muat naik fail laravel: Mengendalikan storan imej dengan betul dan soalan yang sering ditanya. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!