Devuelve una matriz que contiene la ruta y la URL del directorio de carga actual.

Descripción

Comprueba la opción ‘upload_path’, que debería ser de la carpeta raíz web, y si no está vacía, se utilizará. Si está vacío, la ruta será ‘WP_CONTENT_DIR / uploads’. Si se define la constante ‘UPLOADS’, anulará la opción ‘upload_path’ y la ruta ‘WP_CONTENT_DIR / uploads’.

La ruta de la URL de carga se establece mediante la opción ‘upload_url_path’ o utilizando la constante ‘WP_CONTENT_URL’ y agregando ‘/ uploads’ a la ruta.

Si ‘uploads_use_yearmonth_folders’ se establece en verdadero (casilla de verificación si está marcada en el panel de configuración de administración), entonces se utilizará el tiempo. El formato será primero el año y luego el mes.

Si no se pudo crear la ruta, se devolverá un error con la clave ‘error’ que contiene el mensaje de error. El error sugiere que el servidor no puede escribir en el directorio principal.

Parámetros

$ tiempo

(cuerda)(Opcional) Hora formateada en ‘aaaa / mm’.

Valor predeterminado: nulo

$ create_dir

(bool)(Opcional) Ya sea para verificar y crear el directorio de cargas. Valor predeterminado verdadero para compatibilidad con versiones anteriores.

Valor predeterminado: verdadero

$ refresh_cache

(bool)(Opcional) Ya sea para actualizar la caché.

Valor predeterminado: falso

Regreso

(formación) Matriz de información sobre el directorio de carga.

  • ‘sendero’
    (cuerda) Directorio base y subdirectorio o ruta completa para cargar el directorio.
  • ‘url’
    (cuerda) URL base y subdirectorio o URL absoluta para cargar el directorio.
  • ‘subdir’
    (cuerda) Subdirectorio si las cargas usan la opción de carpetas de año / mes está activada.
  • ‘basedir’
    (cuerda) Camino sin subdirectorio.
  • ‘baseurl’
    (cuerda) Ruta de URL sin subdirectorio.
  • ‘error’
    (cadena | falso) Mensaje falso o de error.

Más información

Tenga en cuenta que el uso de esta función creará una subcarpeta en su carpeta de subidas correspondiente al mes consultado (o mes actual, si no $time se proporciona el argumento), si esa carpeta aún no está allí. No tiene que cargar nada para que se cree esta carpeta.

Para crear carpetas personalizadas para usuarios.

$current_user=wp_get_current_user();$upload_dir=wp_upload_dir();if(isset($current_user->user_login)&&!empty($upload_dir['basedir']))$user_dirname=$upload_dir['basedir'].'/'.$current_user->user_login;if(!file_exists($user_dirname))wp_mkdir_p($user_dirname);

Nombre de la carpeta

En caso de que quiera mover el /uploads carpeta, tendrás que usar la UPLOADS constante. Normalmente no debería usarse, ya que solo se define cuando ms_default_constants() se ejecuta (solo multisitio), pero simplemente puede configurar:

define('UPLOADS',trailingslashit(WP_CONTENT_DIR).'custom_uploads_name');

en una instalación de un solo sitio y simplemente funcionará, ya que la función de estructura de directorio público wp_upload_dir() lo configura, cuando se definió:

$dir=ABSPATH.UPLOADS;

Nota: Puede extraer el nombre de la carpeta con la siguiente línea:

// returns `false` if the UPLOADS constant is not defined$upload_dir_name=false;if(defined('UPLOADS'))str_replace(trailingslashit(WP_CONTENT_DIR),'',untrailingslashit(UPLOADS));

Fuente

Expediente: wp-includes / functions.php

functionwp_upload_dir($time=null,$create_dir=true,$refresh_cache=false)

Relacionado

Usos

Usos Descripción
wp-includes / functions.php:_wp_upload_dir ()

Una versión no filtrada ni almacenada en caché de wp_upload_dir () que no comprueba la ruta.
wp-includes / l10n.php:__ ()

Recupere la traducción de $ text.
wp-includes / formatting.php:wp_basename ()

versión compatible con i18n de basename ()
wp-includes / formatting.php:esc_html ()

Escapar de bloques HTML.
wp-includes / load.php:get_current_blog_id ()

Recupere el ID del sitio actual.
wp-includes / functions.php:wp_mkdir_p ()

Creación de directorio recursivo basada en la ruta completa.
wp-includes / functions.php:upload_dir

Filtra los datos del directorio de cargas.
wp-includes / plugin.php:aplicar_filtros ()

Llama a las funciones de devolución de llamada que se han agregado a un enlace de filtro.

Usado por

Usado por Descripción
wp-includes / rest-api / endpoints / class-wp-rest-attachments-controller.php:WP_REST_Attachments_Controller :: edit_media_item ()

Aplica modificaciones a un elemento multimedia y crea un nuevo registro de archivo adjunto.
wp-admin / includes / class-wp-debug-data.php:WP_Debug_Data :: debug_data ()

Función estática para generar datos de depuración del sitio cuando sea necesario.
wp-includes / functions.php:wp_privacy_exports_dir ()

Devuelve el directorio utilizado para almacenar archivos de exportación de datos personales.
wp-includes / functions.php:wp_privacy_exports_url ()

Devuelve la URL del directorio utilizado para almacenar archivos de exportación de datos personales.
wp-includes / functions.php:wp_get_upload_dir ()

Recupera la información del directorio de cargas.
wp-admin / includes / file.php:_wp_handle_upload ()

Maneja cargas PHP en WordPress.
wp-admin / includes / class-file-upload-upgrader.php:File_Upload_Upgrader :: __ construct ()

Construya el mejorador para un formulario.
wp-admin / includes / template.php:wp_import_upload_form ()

Muestra el formulario utilizado por los importadores para aceptar los datos que se van a importar.
wp-includes / functions.php:wp_upload_bits ()

Cree un archivo en la carpeta de carga con el contenido dado.
wp-includes / ms-functions.php:get_space_used ()

Devuelve el espacio utilizado por el sitio actual.

Registro de cambios

Versión Descripción
2.0.0 Introducido.