PHP में touch() फ़ंक्शन फ़ाइल के एक्सेस और मॉडिफिकेशन समय (access and modification time) को सेट करता है। यदि फ़ाइल मौजूद नहीं है तो नई खाली फ़ाइल बनाता है (यदि अनुमति हो)।
सिंटैक्स (Syntax)
touch(string $filename, ?int $mtime = null, ?int $atime = null): bool
पैरामीटर्स (Parameters)
$filename − फ़ाइल पथ।
$mtime (वैकल्पिक) − मॉडिफिकेशन समय (Unix timestamp)। डिफ़ॉल्ट: वर्तमान समय।
$atime (वैकल्पिक) − एक्सेस समय (Unix timestamp)। डिफ़ॉल्ट: $mtime या वर्तमान समय।
रिटर्न वैल्यू (Return Value)
सफलता पर true, विफलता पर false।
उदाहरण (Examples)
उदाहरण 1: वर्तमान समय पर सेट करना (फ़ाइल बनाना/अपडेट करना)
<?php
$file = "new.txt";
if (touch($file)) {
echo "Modification time of $file set to current time.";
} else {
echo "Could not update $file";
}
?>
आउटपुट
Modification time of new.txt set to current time.
उदाहरण 2: विशिष्ट समय सेट करना (भूतकाल)
<?php
$file = "new.txt";
$past = time() - 28800; // 8 घंटे पहले (28800 सेकंड)
if (touch($file, $past)) {
echo "Modification time set to 8 hours ago.";
} else {
echo "Failed";
}
?>
आउटपुट
Modification time of new.txt updated to 8 hrs in the past.
उदाहरण 3: अलग एक्सेस और मॉडिफिकेशन समय
<?php
$file = "test.txt";
$mtime = strtotime("2023-01-01 12:00:00");
$atime = strtotime("2023-01-01 10:00:00");
touch($file, $mtime, $atime);
$stat = stat($file);
echo "Access: " . date("Y-m-d H:i:s", $stat['atime']) . "\n";
echo "Modify: " . date("Y-m-d H:i:s", $stat['mtime']) . "\n";
?>
उदाहरण 4: निर्देशिका पर touch (केवल समय अपडेट)
<?php
touch("mydir"); // निर्देशिका का mtime/atime अपडेट करता है
?>
सामान्य उपयोग मामले
- कैश अमान्यिकरण (cache invalidation) - फ़ाइल समय अपडेट करके पुनर्निर्माण ट्रिगर करना
- बिल्ड सिस्टम - टाइमस्टैम्प आधारित निर्भरता जांच
- परीक्षण - विशिष्ट समय वाली फ़ाइलें बनाना
- लॉक फ़ाइल बनाना -
touch("lockfile")सरल लॉक
सावधानी
- निर्देशिका पर लिखने की अनुमति चाहिए।
- Windows पर समय परिशुद्धता 1 सेकंड तक सीमित हो सकती है।
- PHP 8.0+ में $mtime, $atime nullable हैं।
