README

pickles2/px2agent 提供了 Pickles 2 与 PHP 脚本之间的中介 API。

安装 - Installation

$ composer require pickles2/px2agent;

使用方法 - Usage

$px2agent = new picklesFramework2\px2agent\px2agent();
$px2proj = $px2agent->createProject('/path/to/.px_execute.php');


/**
 * Pickles 2 にクエリを投げて、結果を受け取る (汎用)
 */
$data = $px2proj->query('/?PX=phpinfo', array(
	"output": "json",
));

/**
 * PXコマンドを実行する
 */
$result = $px2proj->px_command(
    'publish.run',
    '/index.html',
    array('path_region' => "/region/")
);

/**
 * バージョン番号を取得する
 */
$value = $px2proj->get_version();


/**
 * configデータを取得する
 */
$value = $px2proj->get_config();

/**
 * サイトマップデータを取得する
 */
$value = $px2proj->get_sitemap();

/**
 * pathまたはidからページ情報を得る
 */
$value = $px2proj->get_page_info('/');

/**
 * 親ページのIDを取得する
 */
$value = $px2proj->get_parent('/sample_pages/');

/**
 * 子階層のページの一覧を取得する
 */
$value = $px2proj->get_children('/');

/**
 * 子階層のページの一覧を、filterを無効にして取得する
 */
$value = $px2proj->get_children('/', array('filter' => false));

/**
 * 同じ階層のページの一覧を取得する
 */
$value = $px2proj->get_bros('/sample_pages/');

/**
 * 同じ階層のページの一覧を、filterを無効にして取得する
 */
$value = $px2proj->get_bros('/sample_pages/', array('filter' => false));

/**
 * 同じ階層の次のページのIDを取得する
 */
$value = $px2proj->get_bros_next('/sample_pages/');

/**
 * 同じ階層の次のページのIDを、filterを無効にして取得する
 */
$value = $px2proj->get_bros_next('/sample_pages/', array('filter' => false));

/**
 * 同じ階層の前のページのIDを取得する
 */
$value = $px2proj->get_bros_prev('/sample_pages/');

/**
 * 同じ階層の前のページのIDを、filterを無効にして取得する
 */
$value = $px2proj->get_bros_prev('/sample_pages/', array('filter' => false));

/**
 * 次のページのIDを取得する
 */
$value = $px2proj->get_next('/sample_pages/');

/**
 * 次のページのIDを、filterを無効にして取得する
 */
$value = $px2proj->get_next('/sample_pages/', array('filter' => false));

/**
 * 前のページのIDを取得する
 */
$value = $px2proj->get_prev('/sample_pages/');

/**
 * 前のページのIDを、filterを無効にして取得する
 */
$value = $px2proj->get_prev('/sample_pages/', array('filter' => false));

/**
 * パンくず配列を取得する
 */
$value = $px2proj->get_breadcrumb_array('/sample_pages/');

/**
 * ダイナミックパス情報を得る
 */
$value = $px2proj->get_dynamic_path_info('/sample_pages/');

/**
 * ダイナミックパスに値をバインドする
 */
$value = $px2proj->bind_dynamic_path_param('/dynamicPath/{*}', array('' => 'abc.html'));

/**
 * role を取得する
 */
$role = $px2proj->get_role('/sample_pages/actor1.html');

/**
 * Actor のページID一覧を取得する
 */
$actors = $px2proj->get_actors('/sample_pages/role.html');

/**
 * get home directory path
 */
$value = $px2proj->get_realpath_homedir();

/**
 * コンテンツルートディレクトリのパス(=install path) を取得する
 */
$value = $px2proj->get_path_controot();

/**
 * DOCUMENT_ROOT のパスを取得する
 */
$value = $px2proj->get_realpath_docroot();

/**
 * get content path
 */
$value = $px2proj->get_path_content('/');

/**
 * ローカルリソースディレクトリのパスを得る
 */
$value = $px2proj->path_files('/', '/images/sample.png');

/**
 * ローカルリソースディレクトリのサーバー内部パスを得る
 */
$value = $px2proj->realpath_files('/', '/images/sample.png');

/**
 * ローカルリソースのキャッシュディレクトリのパスを得る
 */
$value = $px2proj->path_files_cache('/', '/images/sample.png');

/**
 * ローカルリソースのキャッシュディレクトリのサーバー内部パスを得る
 */
$value = $px2proj->realpath_files_cache('/', '/images/sample.png');

/**
 * コンテンツ別の非公開キャッシュディレクトリのサーバー内部パスを得る
 */
$value = $px2proj->realpath_files_private_cache('/', '/images/sample.png');

/**
 * domain を取得する
 */
$value = $px2proj->get_domain();

/**
 * directory_index(省略できるファイル名) の一覧を得る
 */
$value = $px2proj->get_directory_index();

/**
 * 最も優先されるインデックスファイル名を得る
 */
$value = $px2proj->get_directory_index_primary();

/**
 * ファイルの処理方法を調べる
 */
$value = $px2proj->get_path_proc_type('/sample_pages/');

/**
 * リンク先のパスを生成する
 */
$value = $px2proj->href('/sample_pages/');

/**
 * パスがダイナミックパスにマッチするか調べる
 */
$value = $px2proj->is_match_dynamic_path('/sample_pages/');

/**
 * ページが、パンくず内に存在しているか調べる
 */
$value = $px2proj->is_page_in_breadcrumb('/sample_pages/', '/');

/**
 * 除外ファイルか調べる
 */
$value = $px2proj->is_ignore_path('/sample_pages/');


/**
 * パブリッシュする
 */
$output = $px2proj->publish( array(
	"path_region" => "/path/region/",
	"paths_region" => array(
		"/path/region1/",
		"/path/region2/"
	),
	"paths_ignore" => array(
		"/path/region/ignored/1/",
		"/path/region/ignored/2/"
	),
	"keep_cache" => 1,
) );

/**
 * キャッシュを削除する
 */
$output = $px2proj->clearcache();

指定 PHP 二进制文件路径的情况 - Specifying path to PHP binary

$px2agent = new picklesFramework2\px2agent\px2agent( array(
    'bin' => '/path/to/php',
    'ini' => '/path/to/php.ini',
    'extension_dir' => '/path/to/ext/',
) );
$px2proj = $px2agent->createProject('/path/to/.px_execute.php');

开发者信息 - for developers

开发环境设置 - Setting up development environment

$ cd {$project_root}
$ composer install

测试 - Test

$ composer test

文档输出 - JSDoc

$ composer run-script documentation

更新日志 - Change log

pickles2/px2agent v0.2.0 (2023年6月25日)

• 支持 PHP 8.2。

pickles2/px2agent v0.1.0 (2022年1月8日)

• 支持 PHP 版本改为 >=7.3.0。
• 支持 PHP 8.1。

pickles2/px2agent v0.0.4 (2022年1月3日)

• 修复 PHP 命令路径不会传递的错误。

pickles2/px2agent v0.0.3 (2021年1月16日)

• 在 $pj->query() 中添加了新的选项 method、 body、 body_file。

pickles2/px2agent v0.0.2 (2020年12月19日)

• 修复了 Windows 中命令行包含 % 时失败的问题。

pickles2/px2agent v0.0.1 (2020年8月12日)

• 首次发布。

许可 - License

MIT 许可证

作者 - Author

• (C)Tomoya Koyanagi tomk79@gmail.com
• 网站: https://www.pxt.jp/
• 推特: @tomk79 https://twitter.com/tomk79/