Точка.Присутствия Голосов: 0 Адрес блога: http://pointofpresence.ru/ Добавлен: 2014-07-10 01:06:05

Drupal 7: Функции для работы с файловыми путями

2014-06-16 17:17:48 (читать в оригинале)

drupal_basename($uri, $suffix = NULL) — возвращает имя файла. Это аналог PHP функции basename() за исключением того, что поддерживает stream wrappers и имена файлов с не US-ASCII символами.

drupal_basename('sites/default/files/test.jpg'); // test.jpg
drupal_basename('public://test.jpg'); // test.jpg
drupal_basename('/drupal/sites/default/files/test.jpg'); // test.jpg

drupal_dirname($uri) — возвращает директорию файла. Это аналог PHP функции dirname() за исключением того, что поддерживает stream wrappers.

drupal_dirname('sites/default/files/test.jpg'); // sites/default/files
drupal_dirname('public://test.jpg'); // public://
drupal_dirname('/drupal/sites/default/files/test.jpg'); // /drupal/sites/default/files

drupal_realpath($uri) — возвращает абсолютный путь к файлу. Может работать с stream wrappers. Возвращает FALSE если файла не существует. Не рекомендуется к использованию.

drupal_realpath('sites/default/files/test.jpg'); // /drupal/sites/default/files/test.jpg
drupal_realpath('public://test.jpg'); // /drupal/sites/default/files/test.jpg
drupal_realpath('/drupal/sites/default/files/test.jpg'); // /drupal/sites/default/files/test.jpg

file_build_uri($path) — добавляет к пути файла дефолтный протокол (public://).

file_build_uri('test.jpg'); // public://test.jpg

file_create_filename($basename, $directory) — возвращает полный путь для будущего файла с именем $basename в директории $directory. Если файл с таким именем существует, то к имени файла добавляется порядковый номер. Поддерживает stream wrappers.

// если файл test.jpg не существует в указанной директории
file_create_filename('test.jpg', 'sites/default/files'); // sites/default/files/test.jpg
file_create_filename('test.jpg', 'public://'); // public://test.jpg
file_create_filename('test.jpg', '/drupal/sites/default/files/'); // /drupal/sites/default/files/test.jpg
 
// если файл test.jpg существует в указанной директории
file_create_filename('test.jpg', 'sites/default/files'); // sites/default/files/test_0.jpg
file_create_filename('test.jpg', 'public://'); // public://test_0.jpg
file_create_filename('test.jpg', '/drupal/sites/default/files/'); // /drupal/sites/default/files/test_0.jpg

file_create_url($uri) — возвращает URL файла. Поддерживает stream wrappers. Не поддерживает абсолютные пути к файлу.

file_create_url('sites/default/files/test.jpg'); // http://example.com/sites/default/files/test.jpg
file_create_url('public://test.jpg'); // http://example.com/sites/default/files/test.jpg
file_create_url('/drupal/sites/default/files/test.jpg'); // /drupal/sites/default/files/test.jpg

file_destination($destination, $replace) — возвращает путь к существующему файлу в зависимости от значения $replace. Если файла $destination не существует, то функция возвратит то, что передано первым аргументом.

file_destination('sites/default/files/test.jpg', FILE_EXISTS_REPLACE)); // sites/default/files/test.jpg
file_destination('sites/default/files/test.jpg', FILE_EXISTS_RENAME)); // sites/default/files/test_0.jpg
file_destination('sites/default/files/test.jpg', FILE_EXISTS_ERROR)); // FALSE
file_destination('public://test.jpg', FILE_EXISTS_REPLACE)); // public://test.jpg
file_destination('public://test.jpg', FILE_EXISTS_RENAME)); // public://test_0.jpg
file_destination('public://test.jpg', FILE_EXISTS_ERROR)); // FALSE
file_destination('/drupal/sites/default/files/test.jpg', FILE_EXISTS_REPLACE)); // /drupal/sites/default/files/test.jpg
file_destination('/drupal/sites/default/files/test.jpg', FILE_EXISTS_RENAME)); // /drupal/sites/default/files/test_0.jpg
file_destination('/drupal/sites/default/files/test.jpg', FILE_EXISTS_ERROR)); // FALSE

file_directory_temp() — возвращает путь к временной директории, указанной на странице admin/config/media/file-system. Не рекомендуется использовать.

file_directory_temp(); // /tmp

file_munge_filename($filename, $extensions, $alerts = TRUE) — если файл имеет двойное расширение, например file.php.jpg, то функция добавит нижнее подчёркивание к первому расширению, во избежание взлома при криво настроенном апаче.

file_munge_filename('sites/default/files/exploit.php.pps', ''); // sites/default/files/exploit.php_.pps
file_munge_filename('public://exploit.php.pps', ''); // public://exploit.php_.pps
file_munge_filename('/drupal/sites/default/files/exploit.php.pps', ''); // drupal/sites/default/files/exploit.php_.pps

file_unmunge_filename($filename) — отменяет эффект от функции file_munge_filename().

file_unmunge_filename('sites/default/files/exploit.php_.pps'); // sites/default/files/exploit.php.pps
file_unmunge_filename('public://exploit.php_.pps'); // public://exploit.php.pps
file_unmunge_filename('/drupal/sites/default/files/exploit.php_.pps'); // drupal/sites/default/files/exploit.php.pps

file_stream_wrapper_uri_normalize($uri) — нормализует URI файла: удаляет завершающий слэш из имени директории и исправляет тройной слэш в протоколе.

file_stream_wrapper_uri_normalize('sites/all/files/'); // sites/all/files
file_stream_wrapper_uri_normalize('public:///test.jpg'); // public://test.jpg

file_uri_scheme($uri) — возвращает протокол из URI.

file_uri_scheme('public://test.jpg'); // public
file_uri_scheme('temporary://'); // temporary

file_uri_target($uri) — возвращает часть пути без протокола.

file_uri_target('public://test.jpg'); // test.jpg
file_uri_target('temporary://test.jpg'); // test.jpg
file_uri_target('sites/default/files/test.jpg'); // FALSE

file_valid_uri($uri) — возвращает TRUE если в $uri валидный Drupal URI.

file_valid_uri('public://test.jpg'); // TRUE
file_valid_uri('foo://test.jpg'); // FALSE
file_valid_uri('sites/default/files/test.jpg'); // FALSE