touch() (touch)
تابع touch() برای «به روزرسانی زمان فایل» است. «به روزرسانی زمان فایل» یعنی زمان های آخر دسترسی و آخر تغییر فایل. «فایل سیستم (Filesystem)» همان جایی است که فایل ها ذخیره می شوند. اگر فایل نباشد، معمولاً ساخته می شود.
تعریف ساده و سینتکس
touch() زمان تغییر و دسترسی فایل را تنظیم می کند. اگر پارامتر ندهی، زمان فعلی ثبت می شود.
<?php
$filename = "test.txt";
if (touch($filename)) {
echo $filename . " زمان تغییر به حال حاضر تنظیم شد";
} else {
echo "نشد زمان تغییر " . $filename . " را تنظیم کنیم";
}
?>
مثال با زمان دلخواه
می توانی زمان خاص بدهی. همچنین می توانی atime را جداگانه تنظیم کنی.
<?php
$filename = "log.txt";
$time = strtotime("2025-01-01 12:00:00");
$atime = strtotime("2025-01-01 08:00:00");
if (touch($filename, $time, $atime)) {
echo "زمان ها با موفقیت تنظیم شدند";
} else {
echo "تنظیم زمان ها انجام نشد";
}
?>
پارامترها و خروجی
filename: مسیر فایل هدف. اجباری است.
time: زمان تغییر فایل. پیش فرض، زمان سیستم است.
atime: زمان دسترسی فایل. بدون آن، برابر time یا اکنون است.
بازگشت: در موفقیت TRUE و در شکست FALSE.
نکته ها و هشدارها
نکته: اگر فایل وجود نداشته باشد، معمولاً ساخته می شود.
هشدار: روی هاست های محدود، دسترسی نوشتن را بررسی کن.
لینک های مرتبط
برای «به روزرسانی زمان فایل» بیشتر ببین: به روزرسانی زمان فایل.
برای ساخت فایل موقت، سر بزن به tempnam() و tmpfile().
فهرست توابع فایل سیستم W3Schools
جمع بندی سریع
- touch() زمان های فایل را تنظیم می کند.
- بدون زمان، حال حاضر ثبت می شود.
- فایل ممکن است ساخته شود.
- TRUE یعنی عملیات موفق بوده.
- دسترسی نوشتن را بررسی کن.