wp_get_upload_dir()


WordPressのwp_get_upload_dir()関数は、アップロードディレクトリのパスやURLなどの情報を取得するために使用されます。この関数は、アップロードディレクトリのベースURLやベースパス、サブディレクトリのパスなどを含む配列を返します。

構文

wp_get_upload_dir();

戻り値:

  • path (string) — アップロードディレクトリのサーバー上のパス。
  • url (string) — アップロードディレクトリのURL。
  • subdir (string) — サブディレクトリのパス（年/月ベースのディレクトリなど）。
  • basedir (string) — アップロードディレクトリのベースパス。
  • baseurl (string) — アップロードディレクトリのベースURL。
  • error (string) — エラーメッセージ（エラーが発生した場合）。

例1: アップロードディレクトリのパスを取得

アップロードディレクトリのパスを取得して表示します。

<?php $upload_dir = wp_get_upload_dir(); echo $upload_dir['path']; ?>

例2: アップロードディレクトリのURLを取得

アップロードディレクトリのURLを取得して表示します。

<?php $upload_dir = wp_get_upload_dir(); echo $upload_dir['url']; ?>

例3: サブディレクトリのパスを取得

サブディレクトリ（年/月ベースのディレクトリ）のパスを取得します。

<?php $upload_dir = wp_get_upload_dir(); echo $upload_dir['subdir']; ?>

例4: ベースディレクトリのパスを取得

アップロードディレクトリのベースパスを取得します。

<?php $upload_dir = wp_get_upload_dir(); echo $upload_dir['basedir']; ?>

例5: ベースURLを取得

アップロードディレクトリのベースURLを取得します。

<?php $upload_dir = wp_get_upload_dir(); echo $upload_dir['baseurl']; ?>

例6: エラーメッセージを確認

エラーメッセージが存在するか確認します。

<?php $upload_dir = wp_get_upload_dir(); if ( !empty($upload_dir['error']) ) { echo $upload_dir['error']; } ?>

例7: カスタムファイルのパスを生成

アップロードディレクトリ内にカスタムファイルのパスを生成します。

<?php $upload_dir = wp_get_upload_dir(); $custom_file_path = $upload_dir['basedir'] . '/custom-file.txt'; ?>

例8: カスタムファイルのURLを生成

アップロードディレクトリ内にカスタムファイルのURLを生成します。

<?php $upload_dir = wp_get_upload_dir(); $custom_file_url = $upload_dir['baseurl'] . '/custom-file.txt'; ?>

注意点:

  • この関数は、マルチサイト環境でも正しく動作しますが、サイトごとに異なるアップロードディレクトリが設定されている場合があります。
  • アップロードディレクトリのパスやURLは、WordPressの設定によって変更されることがあります。

関連機能：