WordPress 路径相关函数总结（一）：站点路径相关函数

在开发WordPress 相关产品（主题、插件）的时候，常常需要通过某些函数获取路径，包括URL路径和服务器路径。比如说在主题或插件中引用js或css文件需要URL地址，而include一些文件时则需要服务器路径。在WordPress中，不能认定wp-content目录一定位于/wp-content下，也不能认为admin的地址一定是/wp-admin，为了避免错误，了解WordPress中与获取路径相关的函数很重要。

站点路径相关函数，以下以本站 http://devework.com 为例子：

home_url()

返回站点路径，相当于后台设置->常规中的"站点地址（URL）"。

$url = home_url(); echo $url; //输出: http://devework.com

$url = home_url('/images/'); echo $url; //输出：http://devework.com/images/

site_url()

如果WordPress安装在域名根目录下，则该函数与home_url()相同。

如果WordPress安装在子目录下，例如http://devework.com/wordpress，则site_url()返回WordPress实际安装地址，相当于后台->设置->常规中的“WordPress 地址（URL）”。

$url = site_url(); echo $url; //假设WordPress安装在http://devework.com/wordpress下 //输出：http://devework.com/wordpress

admin_url()

返回后台地址，传递参数后也可返回后台menu的地址

$url = admin_url(); echo $url; //输出：http://devework.com/wp-admin/

content_url()

返回实际的wp-content目录，如果是默认安装，且装在根目录下，则如下所示

$url = content_url(); echo $url; //输出：http://devework.com/wp-content

如果在wp-config.php中改变了wp-content目录的位置，则该函数会返回正确地址，例如wp-config.php中如下定义

define('WP_CONTENT_DIR', '/home/user/public_html/cdn'); define('WP_CONTENT_URL', 'http://sola-cdn.me');

则content_url()的返回值为

http://sola-cdn.me

includes_url()

返回当前WordPress站点存放核心文件的目录wp-includes的地址，可以带一个$path作为参数。

$url = includes_url( '/js/'); echo $url; //输出：http://devework.com/wp-includes/js/

wp_upload_dir()

返回WordPress上传目录的地址，是一个数组，包含一系列与上传地址相关的信息。

<?php $upload_dir = wp_upload_dir(); ?>

提供如下信息给你

* 'path' - 上传目录的服务器绝对路径，通常以反斜杠（/）开头 * 'url' - 上传目录的完整URL * 'subdir' - 子目录名称，通常是以年/月形式组织的目录地址，例如/2012/07 * 'basedir' - 上传目录的服务器绝对路径，不包含子目录 * 'baseurl' - 上传目录的完整URL，不包含子目录 * 'error' - 报错信息.

例如

$upload_dir = wp_upload_dir(); echo $upload_dir['baseurl']; //输出：http://devework.com/wp-content/uploads