PHP dirname() 函数

封面图 • 2025-10-10 • PHP

在 PHP 中，`dirname()` 函数用于返回一个文件路径的目录名（即文件所在的目录路径）。

---

### ✅ 语法：

```php
string dirname(string $path)
```

- **参数**：`$path` 是一个字符串，表示文件或目录的路径。
- **返回值**：返回该路径的父目录路径，如果路径中没有目录信息（例如路径是根目录），则返回 `.`（当前目录）。

---

### 📌 示例：

```php
echo dirname("/home/user/file.txt"); // 输出: /home/user
echo dirname("/home/user/");         // 输出: /home
echo dirname("file.txt");            // 输出: . (当前目录)
echo dirname("/");                   // 输出: / (根目录)
echo dirname("C:\\test\\file.txt");  // 在 Windows 上输出: C:\test
```

---

### ⚠️ 注意事项：

- 如果路径中没有斜杠 `/`（例如 `"file.txt"`），`dirname()` 返回 `.`。
- 在 Windows 系统中，路径可以使用反斜杠 `\` 或正斜杠 `/`，但推荐使用正斜杠以保持跨平台兼容性。
- 如果你想要获取更详细的路径信息，可以结合 `realpath()` 使用，例如：

```php
echo dirname(realpath("file.txt")); // 获取真实路径的目录
```

---

### 🧠 常见用途：

- 获取当前脚本所在目录，常用于包含文件或加载配置：
  
  ```php
  $dir = dirname(__FILE__);
  include($dir . '/config.php');
  ```

- 构建相对路径时使用：

```php
  $current_dir = dirname(__FILE__);
  $image_path = $current_dir . '/images/photo.jpg';
  ```

---

如果你有具体的使用场景或问题，欢迎继续提问！