Parallel-Flickr 技术文档

2024-12-25 18:44:45作者：虞亚竹Luna

1. 安装指南

1.1 简短版本

parallel-flickr 是基于 Flamework 构建的，因此它只是一个普通的 Apache + PHP + MySQL 应用程序。你可以将其作为专用虚拟主机运行，或者作为现有主机的一个子目录。

你需要复制 config.php.example 文件并将其重命名为 config.php。然后，你需要更新这个新文件，并添加数据库和第三方 API 的具体配置。

# 你需要有效的 Flickr API 凭证
# 参见：http://www.flickr.com/services/apps/create/apply/

$GLOBALS['cfg']['flickr_api_key'] = '';
$GLOBALS['cfg']['flickr_api_secret'] = '';	

$GLOBALS['cfg']['flickr_api_perms'] = 'read';

# 你需要设置一个 MySQL 数据库并在此处插入具体信息
# 参见：https://github.com/straup/parallel-flickr/blob/master/schema
# 参见：https://github.com/straup/flamework-tools/blob/master/bin/setup-db.sh

$GLOBALS['cfg']['db_main'] = array(
    'host' => 'localhost',
    'name' => 'parallel-flickr',
    'user' => 'parallel-flickr',
    'pass' => '',
    'auto_connect' => 1,
);

# 你需要为网站的各个部分设置加密密钥。不要留空。
# 你可以通过输入 `make secret` 创建新的密钥。
# 参见：https://github.com/straup/parallel-flickr/blob/master/bin/generate_secret.php

$GLOBALS['cfg']['crypto_cookie_secret'] = '';
$GLOBALS['cfg']['crypto_crumb_secret'] = '';
$GLOBALS['cfg']['crypto_password_secret'] = '';

# 如果你没有安装 memcache（或者不知道这是什么），只需留空。
# 否则，将 'cache_remote_engine' 更改为 'memcache'。

$GLOBALS['cfg']['cache_remote_engine'] = '';
$GLOBALS['cfg']['memcache_host'] = 'localhost';
$GLOBALS['cfg']['memcache_port'] = '11211';

# 如果你在无法使 www/templates_c 文件夹可写的服务器上运行 parallel-flickr，
# 请将此设置为 0，但请注意，你需要在模板可以使用之前预编译所有模板。
# 参见：https://github.com/straup/parallel-flickr/blob/master/bin/compile-templates.php

$GLOBALS['cfg']['smarty_compile'] = 1;

1.2 详细版本

从 GitHub 获取代码。

决定你是将项目托管在子域名（例如 parallel-flickr.example.com）还是子目录（例如 www.example.com/parallel-flickr）中。

以下步骤假设：

你将在 example.com 域名的 parallel-flickr 子域上托管项目。
你将使用 Flickr 进行反向地理编码，而不是 reverse-geoplanet 服务。
你希望 parallel-flickr 的 URL 为 parallel-flickr.example.com。
你希望 parallel-flickr 在公共 Web 服务上运行。
<root> 是你的 Web 服务器上配置的子域路径。
你有通过 SSH 访问 Web 服务器的权限。

在 Flickr 上注册：

访问 Flickr API 申请页面。
申请非商业密钥。
将 App name 设置为 parallel-flickr。
将 App description 设置为有意义的描述，例如 An instance of https://github.com/straup/parallel-flickr。
勾选两个选项框。
记下注册过程中提供的 API key 和 API secret。

上传代码及其所有子目录到你的 Web 服务器；不要忘记上传代码根目录中的 .htaccess 文件。

将 <root>/www/include/config.php.example 复制到 <root>/www/include/config.php 并编辑此新文件。

将你的 Flickr Key 复制到配置文件的相应部分：

$GLOBALS['cfg']['flickr_api_key'] = 'my-flickr-key-copied-in-here';
$GLOBALS['cfg']['flickr_api_secret'] = 'my-flickr-secret-copied-in-here';	

$GLOBALS['cfg']['flickr_api_perms'] = 'read';

设置你的数据库名称、数据库用户和数据库密码，并将其复制到：

$GLOBALS['cfg']['db_main'] = array(
    'host' => 'localhost',
    'name' => 'my-database-name',
    'user' => 'my-database-user',
    'pass' => 'my-database-users-password',
    'auto_connect' => 0,
);

设置加密密钥。通过 SSH 连接到你的主机并运行 php <root>/bin/generate_secret.php 三次。将每个密钥复制到：

$GLOBALS['cfg']['crypto_cookie_secret'] = 'first-secret-here';
$GLOBALS['cfg']['crypto_crumb_secret'] = 'second-secret-here';
$GLOBALS['cfg']['crypto_password_secret'] = 'third-secret-here';

创建数据库表。将 <root>/schema/db_main.schema、<root>/schema/db_tickets.schema 和 <root>/schema/db_users.schema 加载到数据库中。你可以通过 phpMyAdmin 的导入选项或通过 mysql 命令行来完成此操作。

浏览到 http://parallel-flickr.example.com。

如果你在 Apache 错误日志中看到类似以下错误：

www/.htaccess: Invalid command 'php_value', perhaps misspelled or defined by a module not included in the server configuration

那么你的主机可能正在以 CGI 而不是模块方式运行 PHP，因此你需要注释掉 <root>/www/.htaccess 中以 php_value 或 php_flag 开头的行，并将这些值放入一个新的文件 <root>/www/php.ini 中，去掉前面的 php_value 或 php_flag。

点击 sign in w/ flickr 并使用 Flickr 进行身份验证。

如果允许，你可以将此命令放入 cron 作业中。