编辑“Gallery:如何从命令行呼叫一个视图或控制器”

=如何从命令行呼叫一个视图或控制器？=
另见：[[Gallery:How_To_Write_Scripts|如何编写与Gallery互作的脚本]]

要求：
* Wget: [http://www.gnu.org/software/wget/wget.html wget] 是一个unix/linux命令行用户代理（user agent），用以自命令行抓取网站。[http://www.interlog.com/~tcharron/wgetwin.html Windows的Wget]同样可用。

此脚本示例首先登入G2，接着运行建立所有缩略图和重设图片维护的任务。

要运行另一个控制器或请求一个视图的话，只要浏览G2中的页面，并复制该页面（视图）或是手工控制器带有所有必要参数的URL（查看一下某页面的HTML源代码找到<form>元素以及论坛输入字段）。接着将所有input field name=value pairs复制到你手动创建的URL中。

 wget --cookies=on  --save-cookies mycookies <nowiki>"http://example.com/gallery2/main.php?g2_controller=core.UserLogin&g2_form[formName]=UserLogin&g2_form[username]=admin&g2_form[password]=mysecret&g2_form[action][login]=Login"</nowiki>
 
 wget --cookies=on --load-cookies mycookies <nowiki>"http://example.com/gallery2/main.php?g2_controller=core.AdminMaintenance&g2_form%5Baction%5D%5BrunTask%5D=1&g2_taskId=BuildDerivativesTask"</nowiki>

将'''mysecret'''替换为你的密码，可能也需要将'''admin'''替换为你的管理员帐户的用户名。并将'''example.com/gallery2/'''替换为你真实的G2地址。

你可以在一个bash脚本中执行上述呼叫
 #!/bin/bash
 在此写入你的命令…
而且你可以周期性地将此bash脚本做为一个cron脚本来执行。

== Caveat ==
自G2.2版本以来，如不做增补的话，'''上述指导就不再适用了'''。鉴于安全性考虑，Gallery不但要求你要登入，而且还要在所有控制器请求中包含一个有效的''authToken''（认证标记）。

这里有一些变通办法：:

=== 创建一个Wrapper脚本 ===
* 参见[[Gallery:How_To_Write_Scripts|如何编写与Gallery互作的脚本]]

你可以编写一个buildDerivatives.php脚本：
<pre>
<?php
/* 调整路径，使其指向你的gallery2文件夹 */
require_once('../gallery2/embed.php');

/*
 * 初始化G2（包括所有必要的类别，
 * 让G2处于可随时处理呼叫的准备状态）
 */
$ret = GalleryEmbed::init(array('fullInit' => true));
check($ret);

/* 抓取authToken */
global $gallery;
$session =& $gallery->getSession();
$authToken = $session->getAuthToken();
GalleryUtilities::putRequestVariable('authToken', $authToken);

/* 在此我们可以呼叫任何API方法或声明控制器请求参量 */
GalleryUtilities::putRequestVariable('controller', 'core.AdminMaintenance');
GalleryUtilities::putRequestVariable('form[action][runTask]', 1);
GalleryUtilities::putRequestVariable('taskId', 'BuildDerivativesTask');

/* 执行上面所定义的控制器请求 */
$data = GalleryEmbed::handleRequest();

/* $data['bodyHtml']包含有结果HTML */

function check($ret) {
    if ($ret) die($ret->getAsHtml());
}
?>
</pre>

你可以由命令行（比如使用cron）呼叫该脚本或者通过<nowiki>http://example.com/gallery2/buildDerivatives.php</nowiki>浏览它。

'''安全性警告：''' 你不应当将此类型的脚本放置在网络可访（web-accessible）的文件夹中（比如你的gallery2/文件夹），因为此脚本会回避auth-token安全机制，而此机制是用于保护你不受恶意网站的攻击的（跨站请求伪造保护，Cross Site Request Forgery Protection）。

=== 抓取Auth Token后将其包括 ===
* 在首次请求登入后，再请求一个包括有表单的视图并分析/检索HTML的g2_authToken字串。
* 接着将auth token前置到你的控制器请求（&g2_authToken=...）。

你可以使用grep或脚本语言将authToken从返回的HTML中解析出来。

[[Category:Gallery 2:Administration and Maintenance]]