Helper
in package
Table of Contents
Methods
- buildJson() : array{media_status: string, media_title: string, media_label: string, media_last_modified: string, media_datetime: string, media_id: int, media_bid: int, media_blog_name: string, media_user_id: int, media_user_name: string, media_last_update_user_id: int|"", media_last_update_user_name: string, media_size: string, media_filesize: int, media_path: string, media_edited: string, media_original: string, media_thumbnail: string, media_permalink: string, media_type: string, media_ext: string, media_caption: string, media_link: string, media_alt: string, media_text: string, media_focal_point: string, media_editable: bool, media_pdf_page: string, checked: false}
- JSONをビルド
- cacheBusting() : string
- キャッシュバスティング
- canEdit() : bool
- メディアを編集できるかどうかを確認
- copyFile() : bool
- ファイルをコピー
- copyFiles() : array{path: string, name: string}
- メディアをコピーして新しいファイルを作成する
- copyImages() : array{path: string, name: string, original: string}
- メディアをコピーして新しい画像ファイルを作成する
- deleteFile() : void
- ファイルを削除
- deleteImage() : void
- 画像ファイルを削除
- deleteItem() : void
- メディアの削除
- deleteTag() : void
- タグを削除
- deleteThumbnail() : void
- サムネイル画像を削除
- downloadFile() : never|void
- メディアファイルのダウンロード
- filterTag() : false|void
- タグをフィルタリング
- getBaseInfo() : array{tags: string, name: string, file: array{name: string, tmp_name: string, type: string, size: int}, size: int, type: string, extension: string}
- メディアの基本情報を取得
- getDownloadLinkHash() : string
- ダウンロードリンクハッシュを取得
- getEditedIcon() : string
- 編集されたアイコンのパスを取得
- getFileOldPermalink() : string
- ファイルの古いパーマリンクを取得
- getFilePermalink() : string
- ファイルのパーマリンクを取得
- getFileThumbnail() : string
- ファイルのサムネイルパスを取得
- getImagePath() : string
- 画像のCMS設置ディレクトリの相対パスを取得
- getImagePermalink() : string
- 画像のパーマリンクを取得
- getImageThumbnail() : string
- 画像のサムネイルパスを取得
- getMedia() : array{mid: int, bid: int, status: string, path: string, thumbnail: string, name: string, size: string, filesize: int, type: string, extension: string, original: string, update_date: string, upload_date: string, field_1: string, field_2: string, field_3: string, field_4: string, field_5: string, field_6: string, blog_name: string, user_id: int, user_name: string, last_update_user_id: int, last_update_user_name: string, editable: bool}|array{}
- メディアを取得
- getMediaArchiveList() : array<string|int, string>
- メディアのアーカイブリストを取得
- getMediaExtensionList() : array<string|int, string>
- メディアの拡張子リストを取得
- getMediaLabel() : string
- メディアのラベルを取得
- getMediaList() : array<string|int, array{path: string, width: string, height: string, permalink: string, icon: string, iconWidth: string, iconHeight: string, extension: string, fileSize: int}>
- メディアIDから整形されたメディア一覧を取得
- getMediaTagList() : array<string|int, string>
- メディアのタグリストを取得
- getOriginal() : string
- オリジナル画像のパスを取得
- getPdfThumbnail() : string
- PDFのサムネイルパスを取得
- getSvgThumbnail() : string
- SVGのサムネイルパスを取得
- injectMediaField() : void
- メディアフィールドの挿入
- insertMedia() : void
- メディアを挿入
- isFile() : bool
- メディアタイプがファイルかどうか
- isImageFile() : bool
- メディアタイプが画像かどうか
- isSvgFile() : bool
- メディアタイプがSVGかどうか
- mediaEagerLoad() : array<int, array<string, mixed>>
- メディアIDからメディア情報を取得
- mediaEagerLoadFromUnit() : array<int, array<string, mixed>>
- ユニットモデル一覧からメディア情報を取得
- rename() : array<string|int, mixed>
- ファイルをリネーム
- sanitizeSvg() : string
- SVG(テキスト)をサニタイズ
- saveTags() : void
- タグを保存
- updateMedia() : void
- メディアを更新
- updateTag() : void
- タグを更新
- uploadFile() : array{path: string, type: string, name: string, size: string, filesize: int, extension: string}|false
- ファイルをアップロード
- uploadImage() : array{path: string, type: "image", name: string, size: string, filesize: int, extension: string}
- 画像をアップロード
- uploadPdfThumbnail() : array{path: string, type: string, name: string, size: string}
- PDFのサムネイルをアップロード
- uploadSvg() : array{path: string, type: string, name: string, size: string, filesize: int}
- SVGをアップロード
- urlencode() : string
- パスをURLエンコード
- validate() : bool
- メディアライブラリの利用が許可されているかどうかを確認
- validateFileName() : array{valid: true}|array{valid: false, error: string, errorCode: string}
- ファイル名のバリデーション(全角・半角両対応版)
- createFile() : array{path: string, type: string, name: string, size: string}
- ファイルをアップロードする
- removeImageFiles() : void
- 画像パスから、サイズ違い・拡張子違い(webp)など含めて削除
Methods
buildJson()
JSONをビルド
public
buildJson(int $mid, array<string|int, mixed> $data, string $tags[, int $bid = BID ]) : array{media_status: string, media_title: string, media_label: string, media_last_modified: string, media_datetime: string, media_id: int, media_bid: int, media_blog_name: string, media_user_id: int, media_user_name: string, media_last_update_user_id: int|"", media_last_update_user_name: string, media_size: string, media_filesize: int, media_path: string, media_edited: string, media_original: string, media_thumbnail: string, media_permalink: string, media_type: string, media_ext: string, media_caption: string, media_link: string, media_alt: string, media_text: string, media_focal_point: string, media_editable: bool, media_pdf_page: string, checked: false}
Parameters
- $mid : int
- $data : array<string|int, mixed>
- $tags : string
- $bid : int = BID
Return values
array{media_status: string, media_title: string, media_label: string, media_last_modified: string, media_datetime: string, media_id: int, media_bid: int, media_blog_name: string, media_user_id: int, media_user_name: string, media_last_update_user_id: int|"", media_last_update_user_name: string, media_size: string, media_filesize: int, media_path: string, media_edited: string, media_original: string, media_thumbnail: string, media_permalink: string, media_type: string, media_ext: string, media_caption: string, media_link: string, media_alt: string, media_text: string, media_focal_point: string, media_editable: bool, media_pdf_page: string, checked: false}cacheBusting()
キャッシュバスティング
public
cacheBusting(string $updated) : string
Parameters
- $updated : string
Return values
stringcanEdit()
メディアを編集できるかどうかを確認
public
canEdit(int $mid) : bool
Parameters
- $mid : int
Return values
boolcopyFile()
ファイルをコピー
public
copyFile(string $from, string $to, bool $isPublic) : bool
Parameters
- $from : string
- $to : string
- $isPublic : bool
Return values
boolcopyFiles()
メディアをコピーして新しいファイルを作成する
public
copyFiles(int $mid[, string $filename = '' ]) : array{path: string, name: string}
Parameters
- $mid : int
- $filename : string = ''
Return values
array{path: string, name: string}copyImages()
メディアをコピーして新しい画像ファイルを作成する
public
copyImages(int $mid[, string $filename = '' ]) : array{path: string, name: string, original: string}
Parameters
- $mid : int
- $filename : string = ''
Return values
array{path: string, name: string, original: string}deleteFile()
ファイルを削除
public
deleteFile(int $mid) : void
Parameters
- $mid : int
deleteImage()
画像ファイルを削除
public
deleteImage(int $mid[, bool $removeOriginal = true ]) : void
Parameters
- $mid : int
- $removeOriginal : bool = true
deleteItem()
メディアの削除
public
deleteItem(int $mid) : void
Parameters
- $mid : int
deleteTag()
タグを削除
public
deleteTag(string $tagName[, int $bid = BID ]) : void
Parameters
- $tagName : string
- $bid : int = BID
deleteThumbnail()
サムネイル画像を削除
public
deleteThumbnail(int $mid) : void
Parameters
- $mid : int
downloadFile()
メディアファイルのダウンロード
public
downloadFile(int $mid) : never|void
Parameters
- $mid : int
Return values
never|voidfilterTag()
タグをフィルタリング
public
filterTag(SQL_Select $SQL, array<string|int, string> $tags) : false|void
Parameters
- $SQL : SQL_Select
- $tags : array<string|int, string>
Return values
false|voidgetBaseInfo()
メディアの基本情報を取得
public
getBaseInfo(array{name: string, tmp_name: string, type: string, size: int} $fileObj, string $tags) : array{tags: string, name: string, file: array{name: string, tmp_name: string, type: string, size: int}, size: int, type: string, extension: string}
Parameters
- $fileObj : array{name: string, tmp_name: string, type: string, size: int}
- $tags : string
Return values
array{tags: string, name: string, file: array{name: string, tmp_name: string, type: string, size: int}, size: int, type: string, extension: string}getDownloadLinkHash()
ダウンロードリンクハッシュを取得
public
getDownloadLinkHash(int $mid) : string
Parameters
- $mid : int
Return values
stringgetEditedIcon()
編集されたアイコンのパスを取得
public
getEditedIcon(string $path) : string
Parameters
- $path : string
Return values
stringgetFileOldPermalink()
ファイルの古いパーマリンクを取得
public
getFileOldPermalink(string $path[, bool $fullpath = true ]) : string
Parameters
- $path : string
- $fullpath : bool = true
Return values
stringgetFilePermalink()
ファイルのパーマリンクを取得
public
getFilePermalink(int $mid[, bool $fullpath = true ]) : string
Parameters
- $mid : int
- $fullpath : bool = true
Return values
stringgetFileThumbnail()
ファイルのサムネイルパスを取得
public
getFileThumbnail(string $extension) : string
Parameters
- $extension : string
Return values
stringgetImagePath()
画像のCMS設置ディレクトリの相対パスを取得
public
getImagePath(string $path) : string
Parameters
- $path : string
Return values
stringgetImagePermalink()
画像のパーマリンクを取得
public
getImagePermalink(string $path) : string
Parameters
- $path : string
Return values
stringgetImageThumbnail()
画像のサムネイルパスを取得
public
getImageThumbnail(string $path) : string
Parameters
- $path : string
Return values
stringgetMedia()
メディアを取得
public
getMedia(int $mid) : array{mid: int, bid: int, status: string, path: string, thumbnail: string, name: string, size: string, filesize: int, type: string, extension: string, original: string, update_date: string, upload_date: string, field_1: string, field_2: string, field_3: string, field_4: string, field_5: string, field_6: string, blog_name: string, user_id: int, user_name: string, last_update_user_id: int, last_update_user_name: string, editable: bool}|array{}
Parameters
- $mid : int
Return values
array{mid: int, bid: int, status: string, path: string, thumbnail: string, name: string, size: string, filesize: int, type: string, extension: string, original: string, update_date: string, upload_date: string, field_1: string, field_2: string, field_3: string, field_4: string, field_5: string, field_6: string, blog_name: string, user_id: int, user_name: string, last_update_user_id: int, last_update_user_name: string, editable: bool}|array{}getMediaArchiveList()
メディアのアーカイブリストを取得
public
getMediaArchiveList(SQL $sql) : array<string|int, string>
Parameters
- $sql : SQL
Return values
array<string|int, string>getMediaExtensionList()
メディアの拡張子リストを取得
public
getMediaExtensionList(SQL $sql) : array<string|int, string>
Parameters
- $sql : SQL
Return values
array<string|int, string>getMediaLabel()
メディアのラベルを取得
public
getMediaLabel(int $mid) : string
Parameters
- $mid : int
Return values
stringgetMediaList()
メディアIDから整形されたメディア一覧を取得
public
getMediaList(array<string|int, int> $midiaIds) : array<string|int, array{path: string, width: string, height: string, permalink: string, icon: string, iconWidth: string, iconHeight: string, extension: string, fileSize: int}>
Parameters
- $midiaIds : array<string|int, int>
Return values
array<string|int, array{path: string, width: string, height: string, permalink: string, icon: string, iconWidth: string, iconHeight: string, extension: string, fileSize: int}>getMediaTagList()
メディアのタグリストを取得
public
getMediaTagList(SQL $sql) : array<string|int, string>
Parameters
- $sql : SQL
Return values
array<string|int, string>getOriginal()
オリジナル画像のパスを取得
public
getOriginal(string $original) : string
Parameters
- $original : string
Return values
stringgetPdfThumbnail()
PDFのサムネイルパスを取得
public
getPdfThumbnail(string $path) : string
Parameters
- $path : string
Return values
stringgetSvgThumbnail()
SVGのサムネイルパスを取得
public
getSvgThumbnail(string $path) : string
Parameters
- $path : string
Return values
stringinjectMediaField()
メディアフィールドの挿入
public
injectMediaField(Field $Field, array<string|int, mixed> $mediaList, array<string|int, string> $useMediaField) : void
Parameters
- $Field : Field
- $mediaList : array<string|int, mixed>
- $useMediaField : array<string|int, string>
insertMedia()
メディアを挿入
public
insertMedia(int $mid, array<string|int, mixed> $data) : void
Parameters
- $mid : int
- $data : array<string|int, mixed>
isFile()
メディアタイプがファイルかどうか
public
isFile(string $type) : bool
Parameters
- $type : string
Return values
boolisImageFile()
メディアタイプが画像かどうか
public
isImageFile(string $type) : bool
Parameters
- $type : string
Return values
boolisSvgFile()
メディアタイプがSVGかどうか
public
isSvgFile(string $type) : bool
Parameters
- $type : string
Return values
boolmediaEagerLoad()
メディアIDからメディア情報を取得
public
mediaEagerLoad(array<string|int, int> $midiaIds) : array<int, array<string, mixed>>
Parameters
- $midiaIds : array<string|int, int>
Return values
array<int, array<string, mixed>>mediaEagerLoadFromUnit()
ユニットモデル一覧からメディア情報を取得
public
mediaEagerLoadFromUnit(UnitCollection $collection) : array<int, array<string, mixed>>
Parameters
- $collection : UnitCollection
Return values
array<int, array<string, mixed>>rename()
ファイルをリネーム
public
rename(array{path: string, type: "image"|"svg"|"file", name: string, extension: string, original: string} $data, string $rename) : array<string|int, mixed>
Parameters
- $data : array{path: string, type: "image"|"svg"|"file", name: string, extension: string, original: string}
- $rename : string
Return values
array<string|int, mixed>sanitizeSvg()
SVG(テキスト)をサニタイズ
public
sanitizeSvg(string $input) : string
Parameters
- $input : string
Return values
stringsaveTags()
タグを保存
public
saveTags(int $mid, string $tags[, int $bid = BID ]) : void
Parameters
- $mid : int
- $tags : string
- $bid : int = BID
updateMedia()
メディアを更新
public
updateMedia(int $mid, array<string|int, mixed> $data) : void
Parameters
- $mid : int
- $data : array<string|int, mixed>
updateTag()
タグを更新
public
updateTag(string $oldTag, string $newTag[, int $bid = BID ]) : void
Parameters
- $oldTag : string
- $newTag : string
- $bid : int = BID
uploadFile()
ファイルをアップロード
public
uploadFile(int $size[, string $fieldName = 'file' ]) : array{path: string, type: string, name: string, size: string, filesize: int, extension: string}|false
Parameters
- $size : int
- $fieldName : string = 'file'
Return values
array{path: string, type: string, name: string, size: string, filesize: int, extension: string}|falseuploadImage()
画像をアップロード
public
uploadImage([string $fieldName = 'file' ][, bool $original = true ]) : array{path: string, type: "image", name: string, size: string, filesize: int, extension: string}
Parameters
- $fieldName : string = 'file'
- $original : bool = true
Return values
array{path: string, type: "image", name: string, size: string, filesize: int, extension: string}uploadPdfThumbnail()
PDFのサムネイルをアップロード
public
uploadPdfThumbnail(string $name) : array{path: string, type: string, name: string, size: string}
Parameters
- $name : string
Return values
array{path: string, type: string, name: string, size: string}uploadSvg()
SVGをアップロード
public
uploadSvg(int $size[, string $fieldName = 'file' ]) : array{path: string, type: string, name: string, size: string, filesize: int}
Parameters
- $size : int
- $fieldName : string = 'file'
Return values
array{path: string, type: string, name: string, size: string, filesize: int}urlencode()
パスをURLエンコード
public
urlencode(string $url) : string
Parameters
- $url : string
Return values
stringvalidate()
メディアライブラリの利用が許可されているかどうかを確認
public
validate([int $bid = BID ]) : bool
Parameters
- $bid : int = BID
Return values
boolvalidateFileName()
ファイル名のバリデーション(全角・半角両対応版)
public
validateFileName(string $fileName) : array{valid: true}|array{valid: false, error: string, errorCode: string}
Parameters
- $fileName : string
-
検証するファイル名(拡張子含む)
Return values
array{valid: true}|array{valid: false, error: string, errorCode: string}createFile()
ファイルをアップロードする
protected
createFile(string $archivesDir[, string $fieldName = 'file' ][, bool $random = true ]) : array{path: string, type: string, name: string, size: string}
Parameters
- $archivesDir : string
- $fieldName : string = 'file'
- $random : bool = true
Tags
Return values
array{path: string, type: string, name: string, size: string}removeImageFiles()
画像パスから、サイズ違い・拡張子違い(webp)など含めて削除
protected
removeImageFiles(string $path[, bool $removeOriginal = true ]) : void
Parameters
- $path : string
-
この値は、ユーザーの入力値など信頼されない値を指定しない
- $removeOriginal : bool = true