# 确定插件和内容目录

<span>在编写 WordPress 插件时，您经常需要在整个 WordPress 安装过程中以及插件或主题中引用各种文件和文件夹。</span>

<span>WordPress 提供了多种函数来轻松确定给定文件或目录所在的位置。始终在插件中使用这些函数，而不是对 wp-content 目录进行硬编码引用或使用 WordPress 内部常量。</span>

<span style="background-color: rgb(191, 237, 210);">WordPress 允许用户将 wp-content 目录放置在任何他们想要的地方，并根据需要重命名它。永远不要假设插件将在 wp-content/plugins 中，上传将在 wp-content/uploads 中，或者主题将在 wp-content/themes 中。</span>

<span>PHP 的`__FILE__`magic-constant 自动解析符号链接，因此如果 `wp-content` 或 `wp-content/plugins` 什至单个插件目录被符号链接，则硬编码路径将无法正常工作。</span>

#### <span>常见用法</span>

<span>如果您的插件包含 JavaScript 文件、CSS 文件或其他外部文件，那么您可能需要这些文件的 URL，以便将它们加载到页面中。为此，您应该使用 </span>[<span>plugins\_url()</span>](https://developer.wordpress.org/reference/functions/plugins_url/)<span> 函数如下：</span>

```php
plugins_url( 'myscript.js', __FILE__ );
```

<span>这将返回 myscript.js 的完整 URL，例如 </span>`example.com/wp-content/plugins/myplugin/myscript.js`<span>。</span>

<span>要将插件的 JavaScript 或 CSS 加载到页面中，您应该分别使用 </span>[`wp_enqueue_script()`](https://developer.wordpress.org/reference/functions/wp_enqueue_script/)<span> 或 </span>[`wp_enqueue_style()`](https://developer.wordpress.org/reference/functions/wp_enqueue_style/)<span> ，将结果 </span>`plugins_url()`<span> 作为文件 URL 传递。</span>

#### <span>可用功能</span>

<span>WordPress 包含许多其他函数，用于确定插件、主题和 WordPress 本身内的文件或目录的路径和 URL。有关其使用的完整信息，请参阅每个功能的单独 DevHub 页面。</span>

#### <span>插件</span>

```php
plugins_url()
plugin_dir_url()
plugin_dir_path()
plugin_basename()
```

#### <span>主题</span>

```php
get_template_directory_uri()
get_stylesheet_directory_uri()
get_stylesheet_uri()
get_theme_root_uri()
get_theme_root()
get_theme_roots()
get_stylesheet_directory()
get_template_directory()
```

#### <span>网站首页</span>

```php
home_url()
get_home_path()
```

#### <span>WordPress</span>

```php
admin_url()
site_url()
content_url()
includes_url()
wp_upload_dir()
```

#### <span>常数</span>

<span>WordPress 在确定内容和插件目录的路径时使用以下常量。这些不应由插件或主题直接使用，但为了完整性而在此处列出。</span>

```php
WP_CONTENT_DIR  // no trailing slash, full paths only
WP_CONTENT_URL  // full url 
WP_PLUGIN_DIR  // full path, no trailing slash
WP_PLUGIN_URL  // full url, no trailing slash

// Available per default in MS, not set in single site install
// Can be used in single site installs (as usual: at your own risk)
UPLOADS // (If set, uploads folder, relative to ABSPATH) (for e.g.: /wp-content/uploads)
```

#### <span>有关的</span>

<span>**WordPress 目录**：</span>

<table id="bkmrk-home_url%28%29-%E4%B8%BB%E9%A1%B5%E7%BD%91%E5%9D%80-http"><tbody><tr><td>[<span>home\_url()</span>](https://developer.wordpress.org/reference/functions/home_url/)</td><td><span>主页网址</span></td><td>[<span>http://www.example.com</span>](http://www.example.com/)</td></tr><tr><td>[site\_url()](https://developer.wordpress.org/reference/functions/site_url/)</td><td><span>站点目录 URL</span></td><td>[<span>http://www.example.com</span>](http://www.example.com/)<span>或</span>[<span>http://www.example.com/wordpress</span>](http://www.example.com/wordpress)</td></tr><tr><td>[admin\_url()](https://developer.wordpress.org/reference/functions/admin_url/)</td><td><span>管理目录 URL</span></td><td>[<span>http://www.example.com/wp-admin</span>](http://www.example.com/wp-admin)</td></tr><tr><td>[includes\_url()](https://developer.wordpress.org/reference/functions/includes_url/)</td><td><span>包含目录 URL</span></td><td>[<span>http://www.example.com/wp-includes</span>](http://www.example.com/wp-includes)</td></tr><tr><td>[content\_url()](https://developer.wordpress.org/reference/functions/content_url/)</td><td><span>内容目录 URL</span></td><td>[<span>http://www.example.com/wp-content</span>](http://www.example.com/wp-content)</td></tr><tr><td>[plugins\_url()](https://developer.wordpress.org/reference/functions/plugins_url/)</td><td><span>插件目录 URL</span></td><td>[<span>http://www.example.com/wp-content/plugins</span>](http://www.example.com/wp-content/plugins)</td></tr><tr><td>[<span>wp\_upload\_dir()</span>](https://developer.wordpress.org/reference/functions/wp_upload_dir/)</td><td><span>上传目录URL（返回数组）</span></td><td>[<span>http://www.example.com/wp-content/uploads</span>](http://www.example.com/wp-content/uploads)</td></tr></tbody></table>