PHP ทำงานกับไฟล์และไดเรกทอรี



อ่านทั้งไฟล์ทีเดียว

<?php
declare(strict_types=1);

$content = file_get_contents(__DIR__ . '/data/note.txt');
if ($content === false) {
    throw new RuntimeException('อ่านไฟล์ไม่ได้');
}
echo $content;

// อ่านเป็นบรรทัด
$lines = file(__DIR__ . '/data/list.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
foreach ($lines as $line) {
    echo "- $line\n";
}

เหมาะกับไฟล์ขนาดพอประมาณ (< สิบ MB) เพราะโหลดเข้าหน่วยความจำทั้งก้อน

เขียนไฟล์

<?php
// เขียนทับ
file_put_contents(__DIR__ . '/log.txt', "บรรทัดใหม่\n");

// ต่อท้าย
file_put_contents(__DIR__ . '/log.txt', "อีกบรรทัด\n", FILE_APPEND);

// ต่อท้าย + ล็อกกันเขียนชนกัน
file_put_contents(
    __DIR__ . '/log.txt',
    date('c') . " event\n",
    FILE_APPEND | LOCK_EX,
);

ไฟล์ใหญ่ — อ่านทีละบรรทัดด้วย fopen

<?php
$handle = fopen(__DIR__ . '/huge.log', 'r');
if ($handle === false) {
    throw new RuntimeException('เปิดไฟล์ไม่ได้');
}

try {
    $errorCount = 0;
    while (($line = fgets($handle)) !== false) {
        if (str_contains($line, 'ERROR')) {
            $errorCount++;
        }
    }
    echo "พบ ERROR $errorCount บรรทัด\n";
} finally {
    fclose($handle);
}

โหมดของ fopen: r อ่าน, w เขียนทับ (สร้างใหม่/ล้าง), a ต่อท้าย, r+ อ่าน+เขียน, เติม b สำหรับ binary (rb, wb)

__DIR__ และ __FILE__ — path ที่ถูกเสมอ

<?php
echo __DIR__, "\n";    // โฟลเดอร์ของไฟล์นี้ (absolute)
echo __FILE__, "\n";   // path เต็มของไฟล์นี้

// ✅ ถูก — อ้างอิงจากตำแหน่งไฟล์
$config = require __DIR__ . '/config/app.php';

// ❌ ผิด — ขึ้นกับ current working directory ที่ไม่แน่นอน
$config = require 'config/app.php';

getcwd() (current working directory) เปลี่ยนได้ตามว่าใครเรียกสคริปต์จากที่ไหน — ใช้ __DIR__ เป็นฐานเสมอ เมื่ออ้าง path ภายในโปรเจกต์

ตรวจสอบไฟล์/โฟลเดอร์

<?php
file_exists($path);      // มีไหม (ไฟล์หรือโฟลเดอร์)
is_file($path);          // เป็นไฟล์
is_dir($path);           // เป็นโฟลเดอร์
is_readable($path);
is_writable($path);
filesize($path);         // ไบต์
filemtime($path);        // เวลาแก้ไขล่าสุด (Unix timestamp)
pathinfo($path);         // ['dirname', 'basename', 'extension', 'filename']
<?php
$info = pathinfo('/var/www/report.2026.pdf');
echo $info['extension'], "\n";   // pdf
echo $info['filename'], "\n";    // report.2026

จัดการโฟลเดอร์

<?php
mkdir(__DIR__ . '/cache/images', 0755, true);   // true = สร้าง parent ให้ด้วย
rename($old, $new);
copy($src, $dest);
unlink($file);                                    // ลบไฟล์
rmdir($emptyDir);                                  // ลบโฟลเดอร์ (ต้องว่าง)

ไล่รายชื่อไฟล์

<?php
// glob — pattern แบบง่าย
foreach (glob(__DIR__ . '/uploads/*.{jpg,png,webp}', GLOB_BRACE) as $file) {
    echo basename($file), ' — ', filesize($file), " ไบต์\n";
}

// วนโฟลเดอร์ย่อยทั้งหมด
$it = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator(__DIR__ . '/src', RecursiveDirectoryIterator::SKIP_DOTS)
);
foreach ($it as $file) {
    if ($file->getExtension() === 'php') {
        echo $file->getPathname(), "\n";
    }
}

$file ในลูปหลังเป็น SplFileInfo — ->getSize(), ->getMTime(), ->isDir(), ->getBasename()

อ่าน/เขียน CSV

<?php
declare(strict_types=1);

// อ่าน
$handle = fopen(__DIR__ . '/users.csv', 'r');
$header = fgetcsv($handle);                    // ['id', 'name', 'email']

$users = [];
while (($row = fgetcsv($handle)) !== false) {
    $users[] = array_combine($header, $row);   // ['id' => '1', 'name' => 'อร', ...]
}
fclose($handle);

// เขียน
$out = fopen(__DIR__ . '/export.csv', 'w');
fputcsv($out, ['id', 'name', 'total']);
foreach ($users as $u) {
    fputcsv($out, [$u['id'], $u['name'], 1500]);
}
fclose($out);

fgetcsv / fputcsv จัดการเรื่อง quote, comma ในค่า, newline ในเซลล์ให้ — อย่า explode(',', $line) เอง

ไฟล์ CSV ที่จะเปิดใน Excel ภาษาไทย: เขียน BOM นำหน้า fwrite($out, "\xEF\xBB\xBF") ก่อน แล้ว Excel จะอ่าน UTF-8 ถูก

ล็อกไฟล์กันเขียนชนกัน

หลาย request เขียนไฟล์เดียวกันพร้อมกัน = ข้อมูลปนกัน flock() แก้:

<?php
$handle = fopen(__DIR__ . '/counter.txt', 'c+');
if (flock($handle, LOCK_EX)) {
    $count = (int) fread($handle, 20);
    $count++;
    rewind($handle);
    ftruncate($handle, 0);
    fwrite($handle, (string) $count);
    fflush($handle);
    flock($handle, LOCK_UN);
}
fclose($handle);

(สำหรับ counter จริง ๆ ใช้ฐานข้อมูลหรือ Redis เหมาะกว่า — นี่แค่แสดงหลักการ)

stream wrapper

PHP มองหลายอย่างเป็น “ไฟล์” ผ่าน wrapper:

<?php
file_get_contents('php://input');            // request body
file_put_contents('php://stderr', "log\n");  // stderr
$data = file_get_contents('https://api.example.com/x');  // HTTP (ถ้า allow_url_fopen เปิด — บทที่ 35 แนะนำ cURL แทน)

เรื่องที่คนมักพลาด

  • อ้าง path แบบ relative ('config/app.php') — พังเมื่อรันจาก cwd อื่น หรือผ่าน cron ใช้ __DIR__ . '/...'
  • file_get_contents ไฟล์ขนาดหลายร้อย MB — หน่วยความจำหมด ใช้ fopen + fgets
  • ไม่เช็คค่าคืน — file_get_contents คืน false เมื่อพัง แล้วโค้ดถัดไปทำงานกับ false
  • explode(',', ...) แทน fgetcsv — พังทันทีเมื่อมี comma ในค่าที่ถูก quote
  • ลืม fclose() — โดยเฉพาะเมื่อ loop เปิดไฟล์เยอะ ๆ หมด file descriptor ใช้ try/finally
  • เขียนไฟล์พร้อมกันหลาย process โดยไม่ LOCK_EX — ข้อมูลทับ/ปนกัน
  • unlink() โดยไม่ basename() path จากผู้ใช้ — ลบไฟล์อะไรก็ได้บนเซิร์ฟเวอร์
  • is_writable() ผ่าน แต่เขียนจริงไม่ได้ — สิทธิ์เปลี่ยนระหว่างเช็คกับเขียน (race) จัดการ error ตอนเขียนจริงด้วย

สรุป

  • ไฟล์เล็ก: file_get_contents / file_put_contents (FILE_APPEND | LOCK_EX เมื่อต่อท้าย)
  • ไฟล์ใหญ่: fopen + fgets ในลูป + fclose ใน finally
  • ใช้ __DIR__ . '/...' เป็นฐาน path เสมอ ไม่พึ่ง cwd
  • ไล่ไฟล์: glob() (pattern ง่าย), RecursiveDirectoryIterator (ลึก) — ได้ SplFileInfo
  • CSV: fgetcsv / fputcsv เสมอ ไม่ explode เอง; BOM นำหน้าถ้าจะเปิดใน Excel
  • flock(LOCK_EX) เมื่อหลาย process เขียนไฟล์เดียวกัน

บทถัดไปว่าด้วยการยิง HTTP request ไปเซิร์ฟเวอร์อื่น — cURL แบบเต็ม, การตั้ง timeout, และการอ่าน JSON ที่ตอบกลับมา