Crea un file nella cartella di upload con il contenuto indicato.

Descrizione

In caso di errore, la chiave 'error' conterrà il messaggio di errore. In caso di successo, la chiave 'file' avrà il percorso univoco del file, la chiave 'url' avrà il collegamento al nuovo file e la chiave 'error' sarà impostata su false.

Questa funzione non sposta un file caricato nella cartella di caricamento. Creerà un nuovo file con il contenuto del parametro $bits. Se si sposta il file caricato, leggere il contenuto del file caricato e poi dare il nome del file e il contenuto a questa funzione, che lo aggiungerà alla cartella di caricamento.

I permessi saranno impostati automaticamente sul nuovo file da questa funzione.

Parametri

$nome

(stringa)(Richiesto)Nome del file.

$deprecato

(nullo|stringa)(Richiesto)Mai utilizzato. Impostare su null.

$bits

(stringa)(Richiesto)Contenuto del file

$tempo

(stringa)(Opzionale) Ora formattata in 'aaaa/mm'.

Valore predefinito: null

Ritorno

(array) Informazioni sul file appena caricato.

  • 'file'
    (stringa) Nome del file appena caricato.
  • 'url'
    (stringa) URL del file caricato.
  • 'tipo'
    (stringa) Tipo di file.
  • 'errore'
    (stringa|falso) Messaggio di errore, se si è verificato un errore.

Fonte

File: wp-includes/functions.php

functionwp_upload_bits($name,$deprecated,$bits,$time=null){if(!empty($deprecated)){_deprecated_argument(__FUNCTION__,'2.0.0');}if(empty($name)){returnarray('error'=>__('Empty filename'));}$wp_filetype=wp_check_filetype($name);if(!$wp_filetype['ext']&&!current_user_can('unfiltered_upload')){returnarray('error'=>__('Sorry, this file type is not permitted for security reasons.'));}$upload=wp_upload_dir($time);if(false!==$upload['error']){return$upload;}/**
	 * Filters whether to treat the upload bits as an error.
	 *
	 * Returning a non-array from the filter will effectively short-circuit preparing the upload bits
	 * and return that value instead. An error message should be returned as a string.
	 *
	 * @since 3.0.0
	 *
	 * @param array|string $upload_bits_error An array of upload bits data, or error message to return.
	 */$upload_bits_error=apply_filters('wp_upload_bits',array('name'=>$name,'bits'=>$bits,'time'=>$time,));if(!is_array($upload_bits_error)){$upload['error']=$upload_bits_error;return$upload;}$filename=wp_unique_filename($upload['path'],$name);$new_file=$upload['path']"/$filename";if(!wp_mkdir_p(dirname($new_file))){if(0===strpos($upload['basedir'],ABSPATH)){$error_path=str_replace(ABSPATH,'',$upload['basedir'])$upload['subdir'];}else{$error_path=wp_basename($upload['basedir'])$upload['subdir'];}$message=sprintf(/* translators: %s: Directory path. */__('Unable to create directory %s. Is its parent directory writable by the server?'),$error_path);returnarray('error'=>$message);}$ifp= @fopen($new_file,'wb');if(!$ifp){returnarray(/* translators: %s: File name. */'error'=>sprintf(__('Could not write file %s'),$new_file),);}fwrite($ifp,$bits);fclose($ifp);clearstatcache();// Set correct file permissions.$stat= @ stat(dirname($new_file));$perms=$stat['mode']&0007777;$perms=$perms&0000666;chmod($new_file,$perms);clearstatcache();// Compute the URL.$url=$upload['url']"/$filename";if(is_multisite()){clean_dirsize_cache($new_file);}/** This filter is documented in wp-admin/includes/file.php */returnapply_filters('wp_handle_upload',array('file'=>$new_file,'url'=>$url,'type'=>$wp_filetype['type'],'error'=>false,),'sideload');}

Correlato

Utilizzi

Usi Descrizione
wp-includes/functions.php: clean_dirsize_cache()

Pulisce la cache delle dimensioni delle cartelle usata da recurse_dirsize().

wp-admin/includes/file.php: wp_handle_upload

Filtra l'array di dati per il file caricato.

wp-includes/capabilities.php: current_user_can()

Restituisce se l'utente corrente ha la capacità specificata.

wp-includes/l10n.php: __()

Recupera la traduzione di $testo.

wp-includes/formatting.php: wp_basename()

versione i18n friendly di basename()

wp-includes/load.php: is_multisite()

Se Multisite è abilitato.

wp-includes/functions.php: _deprecated_argument()

Segna un argomento di una funzione come deprecato e informa quando è stato usato.

wp-includes/functions.php: wp_check_filetype()

Recupera il tipo di file dal nome del file.

wp-includes/functions.php: wp_upload_bits

Filtra se trattare i bit di caricamento come un errore.

wp-includes/functions.php: wp_upload_dir()

Restituisce un array contenente il percorso e l'URL della cartella di caricamento corrente.

wp-includes/functions.php: wp_unique_filename()

Ottiene un nome di file sanificato e unico per la directory indicata.

wp-includes/functions.php: wp_mkdir_p()

Creazione ricorsiva di una cartella basata sul percorso completo.

wp-includes/plugin.php: applica_filtri()

Richiama le funzioni di callback che sono state aggiunte a un gancio per filtri.

Utilizzato da

Usato da Descrizione
wp-admin/includes/image.php: wp_generate_attachment_metadata()

Genera i meta-dati degli allegati e crea le sottodimensioni delle immagini.

wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::mw_newMediaObject()

Carica un file, seguendo le impostazioni.

Changelog

Versione Descrizione
2.0.0 Introdotto.