Баг з переміщенням папки uploads

Схоже напоровся на баг WordPress, який пов’язаний з каталогом завантажень wp-content/uploads. Хоча стверджувати, що це баг я не буду, але логіка точно відсутня…

Розберемося по порядку, справа була така: є у мене старий сайт, який працює ще з версії WP 2+. Під час його створення я перемістив папку файлів uploadsу корінь сайту. Для цього визначив константу в wp-config.php:

define( 'UPLOADS', 'uploads'); // означає, що папка uploads повинна лежати в корені сайту

Також, перейменував папку контенту wp-contentз content. І тому визначив константи у тому wp-config.php:

define( 'WP_CONTENT_DIR', $_SERVER['DOCUMENT_ROOT'].'/content' );
define( 'WP_CONTENT_URL', 'http://'. $_SERVER['HTTP_HOST'] .'/content' );

Все працювало донедавна…

Нещодавно я перемістив ядро ​​WordPress в окрему папку wp– це зручно. Тепер вийшло: ядро ​​лежить в папці wp, плагіни і т.д. contentі файли в і uploadsвсе це в корені сайту.

Після переміщення ядра WordPress, у медіатеці у мене зникли картинки. Подивившись на УРЛ картинок я побачив що УРЛ змінився з /uploadsна /wp/uploadsцьому я не змінював раніше встановлену константу UPLOADS .

Заглянувши в код _wp_upload_dir() (ця функція є основою отримання всіх посилань на файли) побачив, що посилання (url) будуватися з об’єднання UPLOADS з опцією siteurl, а шлях (path) будуватися так: ABSPATH . UPLOADS.

if ( defined( 'UPLOADS' ) && ! ( is_multisite() && get_site_option( 'ms_files_rewriting' ) ) ) {
	$dir = ABSPATH. UPLOADS;
	$url = trailingslashit( $siteurl ) . UPLOADS;
}

Це означає, що за основу береться не корінь сайту, а де знаходиться ядро ​​WordPress, і якщо це вкладений каталог, то UPLOADS буде відноситься вже до цього каталогу. Це не логічно , тому що навряд чи можна віднести папку з файлами сайту до поняття движок… Це контент сайту!

OK раз не можна визначити константу UPLOADS так, щоб файли «дивилися» на корінь сайту, а не корінь движка, будемо видаляти». І видалив константу UPLOADS з wp-config.php , а потім перемістив папку uploads в папку контенту- content .

У результаті загальна структура вийшла така:

/wp/wp-admin
/wp/wp-includes
/content
/content/uploads

Далі, щоб перевірити чи працює як треба, я спробував завантажити картинку в медіатеку, але картинка завантажилася не в очікувану папку: /content/uploads/..., а все в тугіше підпапку движка: /wp/uploads/....

Розслідування показало, що в налаштуваннях WP встановлено опцію upload_path, яка з версій 3.0 не є обов’язковою і не встановлюється за замовчуванням. А у мене там було значення uploadsте саме, що я встановив колись у константі UPLOADS .

Щоб вирішити цю проблему, я просто видалив опцію upload_path. Замінив усі старі посилання у контенті на нові. Для цього я запустив такий SQL запит:

UPDATE wp_posts SET post_content = REPLACE (post_content, 'http://example.com/uploads/', 'http://example.com/content/uploads/');

І про всяк випадок перейменував всі поля guid у вкладень, для цього я зробив міні-плагін .

Навіщо це все?

До того, що якщо ви раптом будите на старому сайті переміщати базові папки WordPress, то зайдіть у всі опції: http://ВАШСАЙТ/wp-admin/options.phpі перевірте, чи не встановлені у вас опції upload_pathі upload_url_pathвони в 99% випадків не потрібні з версії WP 3.0+ і їх можна просто видалити. До речі, на цьому блозі вони теж були і я їх видалив…

У тих випадках, коли вони потрібні, ви швидше за все знатимете про це і ця стаття буде вам не цікава

Також не намагайтеся перенести папку uploadsза межі папки контенту (за промовчанням wp-contents ). Це не вийде, якщо WP винесено в окрему папку. Або це викликає проблеми, якщо в майбутньому ви заходите винести файли движка в окрему папку.