str_getcsv
تابع str_getcsv یک متن CSV را می خواند و به آرایه (Array) تبدیل می کند. CSV یعنی داده ها با جداکننده جدا می شوند. مثل لیست نمره ها که با ویرگول جداست.
تعریف و کاربرد
این تابع رشته ورودی را مثل فایل CSV پردازش می کند. سپس فیلدها را به صورت آرایه برمی گرداند.
نکته: جداکننده پیش فرض کاما است. کاراکتر نقل قول و اسکیپ هم قابل تنظیم هستند.
سینتکس
str_getcsv(string, separator, enclosure, escape)
پارامترها به زبان ساده
- string: متن CSV برای پردازش.
- separator: جداکننده فیلدها؛ پیش فرض ",".
- enclosure: کاراکتر پوشاننده فیلد؛ پیش فرض ".
- escape: کاراکتر اسکیپ؛ پیش فرض \.
مثال 1: استفاده ساده با پیش فرض ها
<?php
$line = "Ali,14,Tehran";
$fields = str_getcsv($line);
print_r($fields);
?>
مثال 2: جداکننده سمی کالن و نقل قول
<?php
$line = "\"Ali Reza\";14;\"Tehran;North\"";
$fields = str_getcsv($line, ";", "\"", "\\");
print_r($fields);
?>
گام های عملی
- رشته CSV را آماده کن.
- در صورت نیاز جداکننده را مشخص کن.
- تابع را اجرا کن و آرایه را بخوان.
نکته: برای خواندن CSV از فایل، از fgetcsv استفاده کن. برای شکستن ساده متن، می توانی explode را هم ببینی.
جمع بندی سریع
- str_getcsv رشته را به آرایه می دهد.
- پیش فرض ها کافی هستند.
- می توانی جداکننده را تغییر دهی.
- فیلدهای نقل قول دار درست پردازش می شوند.