mcpField
B
bitrix-files

bitrix-files

github.com/bxmaximum開発4780 回インストール2 週間前に更新
リポジトリ

bitrix-files について

ストレージ、アップロード、配信、UI アップローダーのワークフローを扱う Bitrix 開発者向けファイル管理スキルです。ファイル ID、検証、非公開ファイルへのアクセス、削除に関する安全な手順を示します。

主な機能

  1. 01CFile によるファイル保存の管理
  2. 02アップロードファイルの検証
  3. 03UI アップローダーの保留ファイル処理
  4. 04権限確認を伴う非公開ファイル配信

活用シーン

  1. 01ID を維持したファイルの保存・置換
  2. 02アクション内でのアップロード検証
  3. 03権限確認後の非公開ファイル配信

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bxmaximum/bitrix-framework-skills --skill bitrix-files

インストール後、Claude Code で/bitrix-filesを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

rules/
delivery.md
storage.md
ui-uploader.md
uploads.md

詳細

Bitrix ファイル

ベースライン：main 23.0+ · 検証済み：main 26.800.0、ui 26.687.0

タスク参照先
保存、読み取り、サイズ変更、削除、b_file の構成、クラウド、ID を維持したままのコンテンツ差し替えrules/storage.md
アクションでアップロードを受け付ける：検証、MIME、レガシーの main.file.inputrules/uploads.md
ui.uploader バックエンド：UploaderController、保留中ファイルの確定rules/ui-uploader.md
ファイルを配信する：BFile、非公開ファイル、ビューアーrules/delivery.md

JS ウィジェット（ui.uploader、ui.viewer）：bitrix-ui。.settings.php のアップローダー設定：bitrix-settings。ファイルフィールド：bitrix-iblocks、bitrix-highloadblock。

不変条件

  • b_file への書き込みは CFile 経由でのみ行います。FileTable は読み取り専用です。add／update／delete を呼び出すと NotImplementedException がスローされます。ファイルの ID を保存し、パスは保存しないでください。
  • URL には CFile::GetFileArray()['SRC'] または CFile::GetPath() を使用します。ローカルのバイト列には CFile::MakeFileArray($id)['tmp_name'] を使用します。/upload/ と SUBDIR を自分で連結しないでください。クラウド、upload_dir オプション、差し替えによって動作しなくなります。
  • クライアント名、MIME、サイズは信頼できない値です。拡張子を許可リストで制限し、コンテンツから MIME を判定し、画像をデコードしてください。
  • ユーザー入力を CFile::MakeFileArray() に渡さないでください。この関数はローカルパス、b_file ID、URL を読み取ります。
  • /upload/ 内のすべてのファイルは URL からアクセス可能です。非公開ファイルは、権限を確認するアクション経由で配信してください。
  • CFile::Delete() は物理ファイルとサイズ変更キャッシュを削除します。この操作は元に戻せません。

コメント

Markdown 対応