PharFileInfo::chmod()函式—用法及示例

函式名稱：PharFileInfo::chmod()

函式描述：該函式用於修改Phar檔案的許可權。

適用版本：PHP 5 >= 5.3.0, PHP 7, PHP 8

語法：public PharFileInfo::chmod ( int $permissions ) : bool

引數：

• permissions：要設定的新許可權，以八進位制表示。例如，0644表示允許所有者讀寫，允許組讀，允許其他人讀。

返回值：如果成功修改許可權，則返回true；否則返回false。

示例：

<?php
$phar = new Phar('myphar.phar');
$file = 'path/to/myfile.txt';
$phar->addFile($file);
$phar->setStub('<?php __HALT_COMPILER();');
$fileInfo = $phar['myfile.txt'];

// 修改檔案許可權為0644
$fileInfo->chmod(0644);

// 檢查檔案許可權是否已修改
echo substr(sprintf('%o', $fileInfo->getPerms()), -4); // 輸出 0644
?>

上述示例中，首先建立了一個名為myphar.phar的Phar檔案，並將路徑為path/to/myfile.txt的檔案新增到Phar檔案中。然後，設定了一個簡單的存根(stub)。接下來，透過使用chmod()函式，將myfile.txt檔案的許可權修改為0644。最後，透過getPerms()方法檢查檔案許可權是否已成功修改，並使用substr()函式將許可權以字串形式輸出。

注意：在使用PharFileInfo::chmod()函式修改Phar檔案許可權時，需要確保當前PHP程序對Phar檔案具有足夠的寫入許可權。