mkdir
(PHP 4, PHP 5, PHP 7, PHP 8)
mkdir — 新建目錄
說明
mkdir(
string
int
bool
resource
): bool
string
$pathname,int
$mode = 0777,bool
$recursive = false,resource
$context = ?): bool
嘗試新建一個由 pathname 指定的目錄。
參數
-
pathname -
目錄的路徑。
-
mode -
預設的 mode 是 0777，意味著最大可能的訪問權。有關 mode 的更多資訊請閱讀 chmod() 頁面。
注意:
mode在 Windows 下被忽略。注意也許想用八進制數指定模式，也就是說該數應以零打頭。模式也會被目前的 umask 修改，可以用 umask() 來改變。
-
recursive -
允許遞迴建立由
pathname所指定的多級巢狀目錄。 -
context -
上下文流（context stream） resource。
返回值
成功時返回 true， 或者在失敗時返回 false。
範例
示例 #1 mkdir() 例子
<?php
mkdir("/path/to/my/dir", 0700);
?>
示例 #2 通過 recursive 參數使用 mkdir()
<?php
// Desired folder structure
$structure = './depth1/depth2/depth3/';
// To create the nested structure, the $recursive parameter
// to mkdir() must be specified.
if (!mkdir($structure, 0777, true)) {
die('Failed to create folders...');
}
// ...
?>
錯誤／異常
目錄已存在時，產生 E_WARNING錯誤。
如果因為許可權問題無法建立目錄，導致 E_WARNING錯誤。