fgetcsv() (fgetcsv)
تابع fgetcsv() یک «خط CSV» را از فایل باز می خواند. «CSV» یعنی داده های جداشده با جداکننده؛ معمولاً کاما.
خواندن CSV در PHP با fgetcsv
طبق منبع، fgetcsv() یک خط را می خواند و به آرایه تبدیل می کند. جداکننده پیش فرض کاما است. همچنین کاراکتر محصورکننده پیش فرض " است. می توانید طول، جداکننده، و محصورکننده را تعیین کنید.
نمونه 1: خواندن یک خط CSV
فایل contacts.csv را باز کن، سپس یک خط بخوان:
<?php
$file = fopen("contacts.csv", "r");
print_r(fgetcsv($file));
fclose($file);
?>
سه گام ساده
نمونه 2: خواندن تا انتهای فایل
تا «انتهای فایل (EOF)» بخوان و هر خط را چاپ کن:
<?php
$file = fopen("contacts.csv", "r");
while (!feof($file)) {
$row = fgetcsv($file);
print_r($row);
}
fclose($file);
?>
جزئیات فنی طبق منبع
خروجی روی موفقیت یک آرایه است. روی فایل نامعتبر مقدار NULL برمی گردد. روی خطاها و در EOF مقدار FALSE برمی گردد. پارامتر escape از PHP 5.3 افزوده شد.
نکته: برای نوشتن CSV از fputcsv() استفاده کن.
fgetcsv در PHP را همیشه همراه با بررسی EOF استفاده کن.
تنظیمات مهم fgetcsv
می توانی طول خط را محدود کنی. می توانی جداکننده را تغییر دهی. همچنین می توانی محصورکننده و escape را تعیین کنی.
جمع بندی سریع
- fgetcsv یک خط CSV را آرایه می کند.
- پیش فرض جداکننده، کاما است.
- در EOF مقدار FALSE می دهد.
- برای نوشتن، fputcsv مناسب است.