Baca daftar jalur dan ukuran asli entri ZIP secara lokal, periksa folder pembungkus serta nama berulang, lalu pahami batas pemeriksaan tanpa ekstraksi.
Kenali susunan arsip sebelum memindahkan isinya
Berkas ZIP sering dipakai untuk menyerahkan hasil pembuatan website atau salinan bahan rilis. Sebelum memindahkannya ke lokasi kerja, Anda dapat membaca inventaris isinya tanpa mengekstrak. Pemeriksaan ini membantu menjawab pertanyaan sederhana: berkas apa yang terdaftar, bagaimana hierarki foldernya, dan apakah susunan tersebut sesuai rencana. Tutorial ini memakai PowerShell untuk membaca metadata arsip lokal, bukan mengunggah hasilnya atau menjalankan kode yang tersimpan di dalam ZIP.
Manfaatnya terlihat ketika dua arsip mempunyai nama luar yang mirip tetapi struktur berbeda. Satu menempatkan index.html langsung di akar, sedangkan yang lain menyimpannya dalam folder proyek. Jika perbedaan baru diketahui setelah penyalinan, lokasi hasil kerja bisa tidak sesuai perkiraan. Inventaris memberi kesempatan meninjau lebih awal. Namun ia tidak membuktikan seluruh isi dapat dibaca, tidak memeriksa perilaku aplikasi, dan tidak menggantikan pengujian rilis. Gunakan hasilnya sebagai satu bukti struktur yang ruang lingkupnya jelas.

Prasyarat dan bahan latihan yang terpisah
Siapkan PowerShell pada Windows yang menyediakan API kompresi .NET, editor teks, dan satu ZIP latihan yang Anda buat sendiri. Misalnya, arsipkan folder kecil berisi index.html dan folder assets dengan berkas site.css. Tidak perlu memakai salinan pelanggan atau arsip produksi untuk percobaan awal. Simpan skrip dan ZIP pada folder latihan yang sama. Pastikan lingkungan kerja memang mengizinkan pelaksanaan skrip lokal sesuai pengaturannya; contoh tidak mengubah kebijakan komputer atau konfigurasi server.
Tuliskan struktur yang diharapkan sebelum menjalankan pemeriksaan. Sebutkan apakah halaman awal seharusnya berada langsung di akar atau di dalam folder pembungkus yang memang disengaja. Tentukan juga berkas yang wajib ada serta contoh berkas kosong jika diperlukan untuk pengujian. Catatan awal membuat hasil lebih mudah dinilai. Tanpa pembanding tersebut, daftar panjang dapat terlihat lengkap meskipun ternyata memuat susunan yang berbeda dari bahan yang diminta oleh pengembang atau pengelola rilis.

Langkah 1: simpan skrip pembaca metadata
Salin kode lengkap berikut ke periksa-zip.ps1 dengan encoding UTF-8. Parameter Path menentukan satu berkas yang dibaca, sedangkan AsJson menyediakan keluaran terstruktur bila diperlukan. Get-Item memakai LiteralPath agar nama yang mengandung karakter tertentu tidak diperlakukan sebagai pola pencarian. Setelah berkas dipastikan bukan folder, OpenRead membukanya dalam mode baca. Bagian finally menutup objek arsip ketika pembacaan selesai, sehingga peninjauan tidak meninggalkan pegangan berkas yang tidak diperlukan.
Kode latihan lengkap — simpan sebagai periksa-zip.ps1: param(
[string]$Path = '.\latihan-rilis.zip',
[switch]$AsJson
)
$ErrorActionPreference = 'Stop'
Add-Type -AssemblyName System.IO.Compression.FileSystem
$item = Get-Item -LiteralPath $Path -ErrorAction Stop
if ($item.PSIsContainer) { throw 'Pilih satu berkas ZIP, bukan folder.' }
$arsip = [System.IO.Compression.ZipFile]::OpenRead($item.FullName)
try {
$rows = @(foreach ($entry in $arsip.Entries) {
[pscustomobject]@{
Jalur = $entry.FullName
ByteAsli = $entry.Length
AkhirSlash = $entry.FullName.EndsWith('/')
}
})
}
finally {
$arsip.Dispose()
}
if ($AsJson) { ConvertTo-Json -InputObject $rows -Depth 3 }
else { $rows | Format-Table -AutoSize }
Skrip tidak memanggil metode ekstraksi atau membuka setiap entri sebagai program. Ia hanya mengumpulkan tiga kolom metadata. Jalur memakai FullName, ByteAsli memakai Length, dan AkhirSlash menandai apakah nama berakhir dengan garis miring. Kolom terakhir merupakan petunjuk bentuk nama, bukan penilaian keamanan sebuah entri. Jika Anda mengembangkan pemeriksaan lebih lanjut, pisahkan aturan tambahan dari pembacaan dasar ini agar arti setiap kolom tetap dapat dijelaskan kepada peninjau.
Langkah 2: jalankan pada ZIP latihan
Buka PowerShell pada folder latihan, lalu jalankan .\periksa-zip.ps1 -Path .\latihan-rilis.zip. Sesuaikan nama ZIP dengan berkas yang benar-benar Anda siapkan. Jika jalurnya mengandung spasi, gunakan tanda kutip di sekeliling argumennya. Hasil berupa tabel daftar entri. Jangan mengganti jalur dengan lokasi server atau folder publik dalam langkah ini. Pemeriksaan ditujukan pada satu arsip lokal yang dapat diulang tanpa menulis isi arsip ke lokasi rilis.
Bila berkas tidak ditemukan atau bukan ZIP yang dapat dibaca, skrip akan berhenti dengan galat. Periksa nama, lokasi, serta bahan latihan yang dipakai, bukan menganggap keluaran kosong sebagai kelulusan. Arsip yang valid tetapi memang tanpa entri merupakan keadaan berbeda dari berkas yang gagal dibuka. Bedakan keduanya pada catatan hasil. Pemeriksaan sebaiknya menyebut berkas yang digunakan dan apakah pembacaan metadata selesai, supaya laporan dapat ditinjau kembali tanpa menebak arsip mana yang dimaksud.
Langkah 3: baca jalur lengkap dan ukuran dengan benar
Microsoft menjelaskan FullName sebagai jalur relatif entri yang mencakup hierarki subdirektori, berbeda dari Name yang hanya memberi nama akhir. Karena itu, index.html dan proyek/index.html perlu dibaca sebagai dua lokasi berbeda. Tinjau beberapa berkas penting bersama pengembang. Jika arsip berasal dari folder pembungkus, pastikan pembungkus tersebut memang bagian dari rencana. Jangan memutuskan lokasi hasil ekstraksi hanya berdasarkan nama berkas terpendek yang terlihat dalam daftar.
Length menunjukkan ukuran entri sebelum kompresi dalam satuan byte. Angka itu berbeda dari ukuran keseluruhan ZIP di pengelola berkas. Entri dengan ukuran nol juga tidak otomatis berarti folder; berkas kosong dapat mempunyai ukuran yang sama. Pada contoh, AkhirSlash hanya memberi tanda nama berakhiran garis miring. Baca jalur serta tujuan entri secara utuh. Tidak ada pernyataan bahwa ukuran metadata saja memastikan isi benar, bebas masalah, atau dapat dipulihkan menjadi website yang berfungsi.
Langkah 4: periksa pembungkus dan nama berulang
Bandingkan inventaris dengan struktur yang sudah Anda tulis. Tandai berkas penting yang hilang, folder pembungkus yang tidak diharapkan, atau nama jalur yang muncul lebih dari sekali. Pembaca metadata tidak menghapus duplikasi; ia menampilkan entri sebagaimana ditemukan. Jika ada nama berulang, minta pembuat arsip menjelaskan susunannya sebelum melanjutkan. Hindari menebak entri mana yang akan dipilih oleh alat ekstraksi yang berbeda atau menganggap seluruh alat mempunyai perilaku penimpaan yang sama.
Untuk latihan pembanding, siapkan arsip kedua yang sengaja mempunyai folder pembungkus tambahan dan jalankan skrip pada berkas tersebut. Catat perubahan jalur yang terlihat. Gunakan juga satu berkas kosong untuk membedakannya dari penanda direktori. Percobaan ini membantu Anda memahami kolom keluaran melalui data yang diketahui asalnya. Daftar metadata tidak perlu disalin ke percakapan terbuka jika nama entri pada pekerjaan nyata memuat informasi internal; pilih contoh rekaan ketika menjelaskan prosedurnya kepada pihak lain.
Langkah 5: simpan hasil terstruktur dan uji ulang
Jika tabel terpotong karena lebar terminal, jalankan .\periksa-zip.ps1 -Path .\latihan-rilis.zip -AsJson. Keluaran JSON mempertahankan nilai jalur dalam bentuk terstruktur dan dapat dipakai untuk catatan pemeriksaan. Perhatikan bahwa format tampilan tabel berbeda dari data yang dibaca. Jangan menyimpulkan sebuah jalur pendek hanya karena terminal memotong kolomnya. Bandingkan isi keluaran dengan nama yang Anda ketahui ada pada bahan latihan, lalu simpan hasil yang relevan untuk peninjauan.
Setelah perubahan pada paket rilis, jalankan pemeriksaan lagi terhadap berkas yang baru. Catat identitas arsip dan hasil pembacaan agar laporan lama tidak tertukar dengan bahan terbaru. Anda dapat menambahkan pemeriksaan integritas atau pengujian isi sebagai pekerjaan terpisah, tetapi jangan mengklaim tahap itu sudah dilakukan oleh skrip ini. Membaca daftar entri belum memeriksa seluruh data terkompresi, belum menilai nama tujuan ekstraksi secara lengkap, dan belum menguji perilaku aplikasi sesudah dipasang.
Kesalahan umum dan verifikasi ulang sebelum serah-terima
Kesalahan yang sering mengaburkan hasil ialah hanya membaca Name, menyamakan byte asli dengan ukuran ZIP, atau menganggap semua entri nol byte sebagai folder. Kesalahan lain adalah mengekstrak lebih dahulu padahal tujuan awal hanya meninjau daftar. Ulangi pemeriksaan menggunakan arsip sederhana, arsip dengan pembungkus, dan arsip kosong yang memang valid agar perbedaannya terlihat. Jika pembacaan gagal, simpan pesan yang relevan beserta konteks berkas latihan, lalu perbaiki sumber masalah sebelum menilai kelengkapannya.
Untuk membahas persiapan situs usaha, kunjungi JagoWeb https://www.jagoweb.com/ dan halaman Website Perusahaan https://www.jagoweb.com/website-perusahaan. Bawa struktur berkas yang diharapkan serta hasil inventaris yang sudah ditinjau saat berdiskusi dengan pengembang. Tanyakan pemeriksaan lanjutan apa yang diperlukan sebelum rilis. Dengan begitu, bukti struktur, integritas bahan, dan fungsi website dapat dinilai sebagai tahap yang jelas, sementara arsip lokal tetap menjadi data yang ditinjau tanpa langsung dijalankan atau dipasang.



