• 欢迎访问微视觉网站,推荐使用最新版火狐浏览器和Chrome浏览器访问本网站,欢迎加入微视觉微视觉-影视后期交流
  • 本站全面支持自动充值,目的是更好的服务大家!
  • 本站全面开启SSL服务,请放心使用!
  • 如果您觉得本站对你非常有用,那么赶紧使用Ctrl+D 收藏吧

WordPress路径相关函数总结

PHP Jason.w.wei 2年前 (2016-04-21) 1358次浏览 已收录 0个评论

WordPress 路径相关函数总结

经常维护网站或者编辑 php 代码的时候,都会使用路径变量。不同的网站有不同的相对和绝对路径。之前都是百度查找,不过每次使用都很麻烦,记不住。这次更新 VipSystem 会员系统插件,顺便把路径的相关函数粘贴过来。希望有所帮助

前言

与 WordPress 打交道,经常遇到的一个问题就是获取路径,包括 URL 路径和服务器路径,在主题或插件中引用 js 或 css 文件需要 URL 地址,而 include 一些文件时则需要服务器路径。在 WordPress 中,不能认定 wp-content 目录一定位于/wp-content 下,也不能认为 admin 的地址一定是/wp-admin,为了避免错误,了解 WordPress 中与获取路径相关的函数很重要。
以下均假设 WordPress 站点安装在 http://www.whwww.net/下

站点路径相关函数

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

$url = home_url();
echo $url;
输出: http://www.whwww.net
$url = home_url('/images/');
echo $url;
输出:http://www.whwww.net/images/

如果 WordPress 安装在域名根目录下,则该函数与 home_url()相同。
如果 WordPress 安装在子目录下,例如 http://www.solagirl.net/wordpress,则 site_url()返回 WordPress 实际安装地址,相当于后台->设置->常规中的“WordPress 地址(URL)”。

$url = site_url();
echo $url;
假设 WordPress 安装在 http://www.whwww.net/wordpress 下
输出:http://www.whwww.net/wordpress

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

$url = admin_url();
echo $url;
输出:http://www.whwww.net/wp-admin/

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

$url = content_url();
echo $url;
输出:http://www.whwww.net/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

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

$url = includes_url( '/js/');
echo $url;
输出:http://www.whwww.net/wp-includes/js/

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

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

提供如下信息给你

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

例如

$upload_dir = wp_upload_dir();
echo $upload_dir['baseurl'];
输出:http://cdn01.whwwww.net/upload

主题路径相关函数

获取存放主题的目录 URI

echo get_theme_root_uri();
输出:http://www.whwww.net/wp-content/themes

获取存放主题的目录的服务器绝对路径

echo get_theme_root();
输出:/home/user/public_html/wp-content/themes

获取主题目录的目录名称,如果你的主题目录是/wp-content/themes,则

echo get_theme_roots();
输出:/themes

获取当前启用的主题目录的服务器绝对路径,例如

/home/user/public_html/wp-content/themes/twentyeleven

可以用来 include 文件,例如

<?php include( get_stylesheet_directory() . '/includes/myfile.php'); ?>

获取当前启用的主题目录的 URI,例如

echo get_stylesheet_directory_uri();
输出:http://www.whwww.net/wp-content/themes/twentyeleven

可以使用在需要主题目录 URI 的场合,例如图片

<img src="<?php echo get_stylesheet_directory_uri() ?>/images/aternus.png" alt="" title="" width="" height="" />

如果当前启用的主题是一个 child theme,该函数返回 parent theme 的主题目录 URI,用法与 get_stylesheet_directory_uri()类似。

如果当前启用的主题是一个 child theme,该函数返回 parent theme 的主题目录的服务器绝对路径,用法与 get_stylesheet_directory()类似。

获取当前启用主题的主题目录名称,例如现在启用的主题为 twentyeleven,则

echo get_stylesheet();
输出:twentyeleven

获取当前启用主题的主题目录名称,与 get_template()的区别是,如果用了 child theme,则返回 child theme 的目录名称。

插件路径相关函数

获取当前插件的目录的 URI,例如一个插件位于/wp-content/plugins/myplugin 下,该目录下放有插件的主文件名为 myplugin.php,在 myplugin.php 中执行下面的代码,结果如下

echo plugins_url();
输出:http://www.whwww.net/wp-content/plugins
echo plugins_url('',__FILE__);
输出:http://www.whwww.net/wp-content/plugins/myplugin
echo plugins_url('js/myscript.js',__FILE__);
输出:http://www.whwww.net/wp-content/plugins/myplugin/js/myscript.js

返回当前插件的目录 URI,例如

echo plugin_dir_url( __FILE__ );
输出:http://www.whwww.net/wp-content/plugins/myplugin/

注意结尾有反斜杠。

返回当前插件目录的服务器绝对路径,例如

echo plugin_dir_path( __FILE__ );
输出:/home/user/public_html/wp-content/plugins/myplugin/

可以用来引用文件,例如

<?php
define( 'MYPLUGINNAME_PATH', plugin_dir_path(__FILE__) );
require MYPLUGINNAME_PATH . 'includes/class-metabox.php';
require MYPLUGINNAME_PATH . 'includes/class-widget.php';
?>

返回调用该函数的插件文件名称(包含插件路径)
例如在插件 myplugin 下的 myplugin.php 文件中调用该函数,结果如下

echo plugin_basename(__FILE__);
输出:myplugin/myplugin.php

如果在 myplugin/include/test.php 文件中调用(test.php 通过 include 引用到 myplugin.php 中),结果如下

echo plugin_basename(__FILE__);
输出:myplugin/include/test.php

路径相关常量

WordPress 中还有一组用 define 定义的常量代表路径。

wp-content 目录的服务器绝对路径,例如

/home/user/public_html/wp-content

wp-content 目录的 URI 地址,例如

http://www.whwww.net/wp-content

插件目录的服务器绝对路径,例如

/home/user/public_html/wp-content/plugins

插件目录的 URI 地址,例如

http://www.whwww.net/wp-content/plugins

当前启用主题目录的服务器绝对路径,相当于 get_template_directory()例如

/home/user/public_html/wp-content/themes/twentyeleven

当前启用主题目录的服务器绝对路径,相当于 get_stylesheet_directory(),与 TEMPLATEPATH 的区别在于如果使用 child theme,该常量指向 child theme 目录。


微视觉 , 版权所有丨如未注明 , 均为网络收集丨本网站采用BY-NC-SA协议进行授权 , 转载请注明WordPress 路径相关函数总结
喜欢 (4)
[wuwei967@126.com]
分享 (0)

您必须 登录 才能发表评论!