a-blog cms PHP API Reference

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
string

canEdit()

メディアを編集できるかどうかを確認

public canEdit(int $mid) : bool
Parameters
$mid : int
Return values
bool

copyFile()

ファイルをコピー

public copyFile(string $from, string $to, bool $isPublic) : bool
Parameters
$from : string
$to : string
$isPublic : bool
Return values
bool

copyFiles()

メディアをコピーして新しいファイルを作成する

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|void

filterTag()

タグをフィルタリング

public filterTag(SQL_Select $SQL, array<string|int, string> $tags) : false|void
Parameters
$SQL : SQL_Select
$tags : array<string|int, string>
Return values
false|void

getBaseInfo()

メディアの基本情報を取得

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
string

getEditedIcon()

編集されたアイコンのパスを取得

public getEditedIcon(string $path) : string
Parameters
$path : string
Return values
string

ファイルの古いパーマリンクを取得

public getFileOldPermalink(string $path[, bool $fullpath = true ]) : string
Parameters
$path : string
$fullpath : bool = true
Return values
string

ファイルのパーマリンクを取得

public getFilePermalink(int $mid[, bool $fullpath = true ]) : string
Parameters
$mid : int
$fullpath : bool = true
Return values
string

getFileThumbnail()

ファイルのサムネイルパスを取得

public getFileThumbnail(string $extension) : string
Parameters
$extension : string
Return values
string

getImagePath()

画像のCMS設置ディレクトリの相対パスを取得

public getImagePath(string $path) : string
Parameters
$path : string
Return values
string

画像のパーマリンクを取得

public getImagePermalink(string $path) : string
Parameters
$path : string
Return values
string

getImageThumbnail()

画像のサムネイルパスを取得

public getImageThumbnail(string $path) : string
Parameters
$path : string
Return values
string

getMedia()

メディアを取得

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
string

getMediaList()

メディア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
string

getPdfThumbnail()

PDFのサムネイルパスを取得

public getPdfThumbnail(string $path) : string
Parameters
$path : string
Return values
string

getSvgThumbnail()

SVGのサムネイルパスを取得

public getSvgThumbnail(string $path) : string
Parameters
$path : string
Return values
string

injectMediaField()

メディアフィールドの挿入

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
bool

isImageFile()

メディアタイプが画像かどうか

public isImageFile(string $type) : bool
Parameters
$type : string
Return values
bool

isSvgFile()

メディアタイプがSVGかどうか

public isSvgFile(string $type) : bool
Parameters
$type : string
Return values
bool

mediaEagerLoad()

メディア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
string

saveTags()

タグを保存

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}|false

uploadImage()

画像をアップロード

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
string

validate()

メディアライブラリの利用が許可されているかどうかを確認

public validate([int $bid = BID ]) : bool
Parameters
$bid : int = BID
Return values
bool

validateFileName()

ファイル名のバリデーション(全角・半角両対応版)

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
throws
RuntimeException
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

        
On this page

Search results