mirror of
https://github.com/WordPress/WordPress.git
synced 2024-08-21 05:12:59 +02:00
This changeset updates various comments as per WordPress PHP Inline Documentation Standards. See https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/#5-inline-comments. Follow-up to [56174], [56175], [56176], [56177], [56178], [56179], [56180], [56191]. Props costdev, audrasjb. See #58459. Built from https://develop.svn.wordpress.org/trunk@56192 git-svn-id: http://core.svn.wordpress.org/trunk@55704 1a063a9b-81f0-0310-95a4-ce76da25c4cd
183 lines
4.8 KiB
PHP
183 lines
4.8 KiB
PHP
<?php
|
|
/**
|
|
* Defines constants and global variables that can be overridden, generally in wp-config.php.
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Multisite
|
|
* @since 3.0.0
|
|
*/
|
|
|
|
/**
|
|
* Defines Multisite upload constants.
|
|
*
|
|
* Exists for backward compatibility with legacy file-serving through
|
|
* wp-includes/ms-files.php (wp-content/blogs.php in MU).
|
|
*
|
|
* @since 3.0.0
|
|
*/
|
|
function ms_upload_constants() {
|
|
// This filter is attached in ms-default-filters.php but that file is not included during SHORTINIT.
|
|
add_filter( 'default_site_option_ms_files_rewriting', '__return_true' );
|
|
|
|
if ( ! get_site_option( 'ms_files_rewriting' ) ) {
|
|
return;
|
|
}
|
|
|
|
// Base uploads dir relative to ABSPATH.
|
|
if ( ! defined( 'UPLOADBLOGSDIR' ) ) {
|
|
define( 'UPLOADBLOGSDIR', 'wp-content/blogs.dir' );
|
|
}
|
|
|
|
/*
|
|
* Note, the main site in a post-MU network uses wp-content/uploads.
|
|
* This is handled in wp_upload_dir() by ignoring UPLOADS for this case.
|
|
*/
|
|
if ( ! defined( 'UPLOADS' ) ) {
|
|
$site_id = get_current_blog_id();
|
|
|
|
define( 'UPLOADS', UPLOADBLOGSDIR . '/' . $site_id . '/files/' );
|
|
|
|
// Uploads dir relative to ABSPATH.
|
|
if ( 'wp-content/blogs.dir' === UPLOADBLOGSDIR && ! defined( 'BLOGUPLOADDIR' ) ) {
|
|
define( 'BLOGUPLOADDIR', WP_CONTENT_DIR . '/blogs.dir/' . $site_id . '/files/' );
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Defines Multisite cookie constants.
|
|
*
|
|
* @since 3.0.0
|
|
*/
|
|
function ms_cookie_constants() {
|
|
$current_network = get_network();
|
|
|
|
/**
|
|
* @since 1.2.0
|
|
*/
|
|
if ( ! defined( 'COOKIEPATH' ) ) {
|
|
define( 'COOKIEPATH', $current_network->path );
|
|
}
|
|
|
|
/**
|
|
* @since 1.5.0
|
|
*/
|
|
if ( ! defined( 'SITECOOKIEPATH' ) ) {
|
|
define( 'SITECOOKIEPATH', $current_network->path );
|
|
}
|
|
|
|
/**
|
|
* @since 2.6.0
|
|
*/
|
|
if ( ! defined( 'ADMIN_COOKIE_PATH' ) ) {
|
|
$site_path = parse_url( get_option( 'siteurl' ), PHP_URL_PATH );
|
|
if ( ! is_subdomain_install() || is_string( $site_path ) && trim( $site_path, '/' ) ) {
|
|
define( 'ADMIN_COOKIE_PATH', SITECOOKIEPATH );
|
|
} else {
|
|
define( 'ADMIN_COOKIE_PATH', SITECOOKIEPATH . 'wp-admin' );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @since 2.0.0
|
|
*/
|
|
if ( ! defined( 'COOKIE_DOMAIN' ) && is_subdomain_install() ) {
|
|
if ( ! empty( $current_network->cookie_domain ) ) {
|
|
define( 'COOKIE_DOMAIN', '.' . $current_network->cookie_domain );
|
|
} else {
|
|
define( 'COOKIE_DOMAIN', '.' . $current_network->domain );
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Defines Multisite file constants.
|
|
*
|
|
* Exists for backward compatibility with legacy file-serving through
|
|
* wp-includes/ms-files.php (wp-content/blogs.php in MU).
|
|
*
|
|
* @since 3.0.0
|
|
*/
|
|
function ms_file_constants() {
|
|
/**
|
|
* Optional support for X-Sendfile header
|
|
*
|
|
* @since 3.0.0
|
|
*/
|
|
if ( ! defined( 'WPMU_SENDFILE' ) ) {
|
|
define( 'WPMU_SENDFILE', false );
|
|
}
|
|
|
|
/**
|
|
* Optional support for X-Accel-Redirect header
|
|
*
|
|
* @since 3.0.0
|
|
*/
|
|
if ( ! defined( 'WPMU_ACCEL_REDIRECT' ) ) {
|
|
define( 'WPMU_ACCEL_REDIRECT', false );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Defines Multisite subdomain constants and handles warnings and notices.
|
|
*
|
|
* VHOST is deprecated in favor of SUBDOMAIN_INSTALL, which is a bool.
|
|
*
|
|
* On first call, the constants are checked and defined. On second call,
|
|
* we will have translations loaded and can trigger warnings easily.
|
|
*
|
|
* @since 3.0.0
|
|
*/
|
|
function ms_subdomain_constants() {
|
|
static $subdomain_error = null;
|
|
static $subdomain_error_warn = null;
|
|
|
|
if ( false === $subdomain_error ) {
|
|
return;
|
|
}
|
|
|
|
if ( $subdomain_error ) {
|
|
$vhost_deprecated = sprintf(
|
|
/* translators: 1: VHOST, 2: SUBDOMAIN_INSTALL, 3: wp-config.php, 4: is_subdomain_install() */
|
|
__( 'The constant %1$s <strong>is deprecated</strong>. Use the boolean constant %2$s in %3$s to enable a subdomain configuration. Use %4$s to check whether a subdomain configuration is enabled.' ),
|
|
'<code>VHOST</code>',
|
|
'<code>SUBDOMAIN_INSTALL</code>',
|
|
'<code>wp-config.php</code>',
|
|
'<code>is_subdomain_install()</code>'
|
|
);
|
|
|
|
if ( $subdomain_error_warn ) {
|
|
trigger_error(
|
|
sprintf(
|
|
/* translators: 1: VHOST, 2: SUBDOMAIN_INSTALL */
|
|
__( '<strong>Conflicting values for the constants %1$s and %2$s.</strong> The value of %2$s will be assumed to be your subdomain configuration setting.' ),
|
|
'<code>VHOST</code>',
|
|
'<code>SUBDOMAIN_INSTALL</code>'
|
|
) . ' ' . $vhost_deprecated,
|
|
E_USER_WARNING
|
|
);
|
|
} else {
|
|
_deprecated_argument( 'define()', '3.0.0', $vhost_deprecated );
|
|
}
|
|
|
|
return;
|
|
}
|
|
|
|
if ( defined( 'SUBDOMAIN_INSTALL' ) && defined( 'VHOST' ) ) {
|
|
$subdomain_error = true;
|
|
if ( SUBDOMAIN_INSTALL !== ( 'yes' === VHOST ) ) {
|
|
$subdomain_error_warn = true;
|
|
}
|
|
} elseif ( defined( 'SUBDOMAIN_INSTALL' ) ) {
|
|
$subdomain_error = false;
|
|
define( 'VHOST', SUBDOMAIN_INSTALL ? 'yes' : 'no' );
|
|
} elseif ( defined( 'VHOST' ) ) {
|
|
$subdomain_error = true;
|
|
define( 'SUBDOMAIN_INSTALL', 'yes' === VHOST );
|
|
} else {
|
|
$subdomain_error = false;
|
|
define( 'SUBDOMAIN_INSTALL', false );
|
|
define( 'VHOST', 'no' );
|
|
}
|
|
}
|