WordPress 路径相关函数总结

2016 年 3 月 26 日原创教程 建站历程35,521

经常维护网站或者编辑 php 代码的时候，都会使用路径变量。不同的网站有不同的相对和绝对路径。之前都是百度查找，不过每次使用都很麻烦，记不住。这次更新 VipSystem 会员系统插件，顺便把路径的相关函数粘贴过来。希望有所帮助文章源自狐狸影视城-https://fox-studio.net/31067.html

  文章源自狐狸影视城-https://fox-studio.net/31067.html

前言

与 WordPress 打交道，经常遇到的一个问题就是获取路径，包括 URL 路径和服务器路径，在主题或插件中引用 js 或 css 文件需要 URL 地址，而 include 一些文件时则需要服务器路径。在 WordPress 中，不能认定 wp-content 目录一定位于/wp-content 下，也不能认为 admin 的地址一定是/wp-admin，为了避免错误，了解 WordPress 中与获取路径相关的函数很重要。文章源自狐狸影视城-https://fox-studio.net/31067.html

以下均假设 WordPress 站点安装在 http://www.fox-studio.net 下文章源自狐狸影视城-https://fox-studio.net/31067.html

  文章源自狐狸影视城-https://fox-studio.net/31067.html

站点路径相关函数

HOME_URL() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

返回站点路径，相当于后台设置-> 常规中的"站点地址 （URL）"。文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. $url = home_url();
  2. echo $url;
  4. //输出: http://www.fox-studio.net
  1. $url = home_url('/images/');
  2. echo $url;
  4. 输出：http://www.fox-studio.net/images/

  文章源自狐狸影视城-https://fox-studio.net/31067.html

SITE_URL() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

如果 WordPress 安装在域名根目录下，则该函数与 home_url() 相同。文章源自狐狸影视城-https://fox-studio.net/31067.html

如果 WordPress 安装在子目录下，例如 http://www.solagirl.net/wordpress，则 site_url() 返回 WordPress 实际安装地址，相当于后台-> 设置-> 常规中的 「WordPress 地址 （URL）」。文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. $url = site_url();
  2. echo $url;
  4. //假设 WordPress 安装在 http://www.fox-studio.net/wordpress 下
  5. //输出：http://www.fox-studio.net/wordpress

  文章源自狐狸影视城-https://fox-studio.net/31067.html

ADMIN_URL() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

返回后台地址，传递参数后也可返回后台 menu 的地址。文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. $url = admin_url();
  2. echo $url;
  4. //输出：http://www.fox-studio.net/wp-admin/

  文章源自狐狸影视城-https://fox-studio.net/31067.html

CONTENT_URL() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

返回实际的 wp-content 目录，如果是默认安装，且装在根目录下，则如下所示文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. $url = content_url();
  2. echo $url;
  4. //输出：http://www.fox-studio.net/wp-content

如果在 wp-config.php 中改变了 wp-content 目录的位置，则该函数会返回正确地址，例如 wp-config.php 中如下定义文章源自狐狸影视城-https://fox-studio.net/31067.html

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

则 content_url() 的返回值为文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. http://sola-cdn.me

  文章源自狐狸影视城-https://fox-studio.net/31067.html

INCLUDES_URL() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

返回当前 WordPress 站点存放核心文件的目录 wp-includes 的地址，可以带一个 $path 作为参数。文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. $url = includes_url( '/js/');
  2. echo $url;
  4. //输出：http://www.fox-studio.net/wp-includes/js/

  文章源自狐狸影视城-https://fox-studio.net/31067.html

WP_UPLOAD_DIR() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

返回 WordPress 上传目录的地址，是一个数组，包含一系列与上传地址相关的信息。文章源自狐狸影视城-https://fox-studio.net/31067.html

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

提供如下信息给你文章源自狐狸影视城-https://fox-studio.net/31067.html

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

例如文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. $upload_dir = wp_upload_dir();
  2. echo $upload_dir['baseurl'];
  4. //输出：http://www.fox-studio.net/wp-content/uploads

  文章源自狐狸影视城-https://fox-studio.net/31067.html

主题路径相关函数

GET_THEME_ROOT_URI() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

获取存放主题的目录 URI 文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. echo get_theme_root_uri();
  3. //输出：http://www.fox-studio.net/wp-content/themes

  文章源自狐狸影视城-https://fox-studio.net/31067.html

GET_THEME_ROOT() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

获取存放主题的目录的服务器绝对路径文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. echo get_theme_root();
  3. //输出：/home/user/public_html/wp-content/themes

  文章源自狐狸影视城-https://fox-studio.net/31067.html

GET_THEME_ROOTS() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

获取主题目录的目录名称，如果你的主题目录是/wp-content/themes，则文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. echo get_theme_roots();
  3. //输出：/themes

  文章源自狐狸影视城-https://fox-studio.net/31067.html

GET_STYLESHEET_DIRECTORY() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

获取当前启用的主题目录的服务器绝对路径，例如文章源自狐狸影视城-https://fox-studio.net/31067.html

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

可以用来 include 文件，例如文章源自狐狸影视城-https://fox-studio.net/31067.html

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

  文章源自狐狸影视城-https://fox-studio.net/31067.html

GET_STYLESHEET_DIRECTORY_URI() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

获取当前启用的主题目录的 URI，例如文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. echo get_stylesheet_directory_uri();
  3. //输出：http://www.fox-studio.net/wp-content/themes/twentyeleven

可以使用在需要主题目录 URI 的场合，例如图片文章源自狐狸影视城-https://fox-studio.net/31067.html

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

  文章源自狐狸影视城-https://fox-studio.net/31067.html

GET_TEMPLATE_DIRECTORY_URI() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

如果当前启用的主题是一个 child theme，该函数返回 parent theme 的主题目录 URI，用法与 get_stylesheet_directory_uri() 类似。文章源自狐狸影视城-https://fox-studio.net/31067.html

  文章源自狐狸影视城-https://fox-studio.net/31067.html

GET_TEMPLATE_DIRECTORY() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

如果当前启用的主题是一个 child theme，该函数返回 parent theme 的主题目录的服务器绝对路径，用法与 get_stylesheet_directory() 类似。文章源自狐狸影视城-https://fox-studio.net/31067.html

  文章源自狐狸影视城-https://fox-studio.net/31067.html

GET_TEMPLATE() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

获取当前启用主题的主题目录名称，例如现在启用的主题为 twentyeleven，则文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. echo get_stylesheet();
  3. //输出：twentyeleven

  文章源自狐狸影视城-https://fox-studio.net/31067.html

GET_STYLESHEET() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

获取当前启用主题的主题目录名称，与 get_template() 的区别是，如果用了 child theme，则返回 child theme 的目录名称。文章源自狐狸影视城-https://fox-studio.net/31067.html

  文章源自狐狸影视城-https://fox-studio.net/31067.html

插件路径相关函数

PLUGINS_URL() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

获取当前插件的目录的 URI，例如一个插件位于/wp-content/plugins/myplugin 下，该目录下放有插件的主文件名为 myplugin.php，在 myplugin.php 中执行下面的代码，结果如下文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. echo plugins_url();
  3. //输出：http://www.fox-studio.net/wp-content/plugins
  1. echo plugins_url('',__FILE__);
  3. //输出：http://www.fox-studio.net/wp-content/plugins/myplugin
  1. echo plugins_url('js/myscript.js',__FILE__);
  3. //输出：http://www.fox-studio.net/wp-content/plugins/myplugin/js/myscript.js

  文章源自狐狸影视城-https://fox-studio.net/31067.html

PLUGIN_DIR_URL() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

返回当前插件的目录 URI，例如文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. echo plugin_dir_url( __FILE__ );
  3. //输出：http://www.fox-studio.net/wp-content/plugins/myplugin/

注意结尾有反斜杠。文章源自狐狸影视城-https://fox-studio.net/31067.html

  文章源自狐狸影视城-https://fox-studio.net/31067.html

PLUGIN_DIR_PATH() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

返回当前插件目录的服务器绝对路径，例如文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. echo plugin_dir_path( __FILE__ );
  3. //输出：/home/user/public_html/wp-content/plugins/myplugin/

可以用来引用文件，例如文章源自狐狸影视城-https://fox-studio.net/31067.html

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

  文章源自狐狸影视城-https://fox-studio.net/31067.html

PLUGIN_BASENAME() >>文章源自狐狸影视城-https://fox-studio.net/31067.html

返回调用该函数的插件文件名称 （包含插件路径） 文章源自狐狸影视城-https://fox-studio.net/31067.html

例如在插件 myplugin 下的 myplugin.php 文件中调用该函数，结果如下文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. echo plugin_basename(__FILE__);
  3. //输出：myplugin/myplugin.php

如果在 myplugin/include/test.php 文件中调用 （test.php 通过 include 引用到 myplugin.php 中），结果如下文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. echo plugin_basename(__FILE__);
  3. //输出：myplugin/include/test.php

  文章源自狐狸影视城-https://fox-studio.net/31067.html

路径相关常量

WordPress 中还有一组用 define 定义的常量代表路径。文章源自狐狸影视城-https://fox-studio.net/31067.html

WP_CONTENT_DIR文章源自狐狸影视城-https://fox-studio.net/31067.html

wp-content 目录的服务器绝对路径，例如文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. /home/user/public_html/wp-content

  文章源自狐狸影视城-https://fox-studio.net/31067.html

WP_CONTENT_URL文章源自狐狸影视城-https://fox-studio.net/31067.html

wp-content 目录的 URI 地址，例如文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. http://www.fox-studio.net/wp-content

  文章源自狐狸影视城-https://fox-studio.net/31067.html

WP_PLUGIN_DIR文章源自狐狸影视城-https://fox-studio.net/31067.html

插件目录的服务器绝对路径，例如文章源自狐狸影视城-https://fox-studio.net/31067.html

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

  文章源自狐狸影视城-https://fox-studio.net/31067.html

WP_PLUGIN_URL文章源自狐狸影视城-https://fox-studio.net/31067.html

插件目录的 URI 地址，例如文章源自狐狸影视城-https://fox-studio.net/31067.html

  1. http://www.fox-studio.net/wp-content/plugins

  文章源自狐狸影视城-https://fox-studio.net/31067.html

TEMPLATEPATH文章源自狐狸影视城-https://fox-studio.net/31067.html

当前启用主题目录的服务器绝对路径，相当于 get_template_directory() 例如文章源自狐狸影视城-https://fox-studio.net/31067.html

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

  文章源自狐狸影视城-https://fox-studio.net/31067.html

STYLESHEETPATH文章源自狐狸影视城-https://fox-studio.net/31067.html

当前启用主题目录的服务器绝对路径，相当于 get_stylesheet_directory()，与 TEMPLATEPATH 的区别在于如果使用 child theme，该常量指向 child theme 目录。文章源自狐狸影视城-https://fox-studio.net/31067.html

weinxin
千年骚狐
  • 本文由 发表于 2016 年 3 月 26 日
  • 除非特殊声明，本站文章均为原创，转载请务必保留本文链接
评论：3    其中：访客  2    博主  1
    • 912884156
      912884156 1
      2016 年 6 月 23 日 下午 10:34 1F
      回复

      狐狸 你建站的空间这个问题 是怎么解决的？
      需要多大的空间合适？
      有没有好的减小成本的办法？

        • 千年骚狐
          千年骚狐
          2016 年 6 月 23 日 下午 11:29 B1
          回复

          @ 912884156 网站程序很小不占用空间，就是网站上传的附件，文章图片 视频等。你可以放到别的便宜的空间。

      匿名

      发表评论

      匿名网友 填写信息

      :?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen:

      确定