WordPress主题开发：获取站点URL路径和服务器路径的函数

在开发WordPress主题或插件的时候，常常需要通过某些函数获取路径，包括URL路径和服务器路径。

比如在主题或插件中，引用的js文件或css文件需要URL地址，而include一些文件时则需要服务器路径。所以，了解WordPress中与获取路径相关的函数很重要。

home_url()

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

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

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

site_url()

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

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

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

admin_url()

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

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

content_url()

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

$url = content_url();
echo $url;
//输出：http://domain.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://domain2.com');

则content_url()的返回值为

http://domain2.com

includes_url()

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

$url = includes_url( '/js/');
echo $url;
//输出：http://domain.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://domain.com/wp-content/uploads