首页
/ Parallel-Flickr 技术文档

Parallel-Flickr 技术文档

2024-12-25 09:22:50作者:虞亚竹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 上注册:

  1. 访问 Flickr API 申请页面
  2. 申请非商业密钥。
  3. App name 设置为 parallel-flickr
  4. App description 设置为有意义的描述,例如 An instance of https://github.com/straup/parallel-flickr
  5. 勾选两个选项框。
  6. 记下注册过程中提供的 API keyAPI 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_valuephp_flag 开头的行,并将这些值放入一个新的文件 <root>/www/php.ini 中,去掉前面的 php_valuephp_flag

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

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

2. 项目使用说明

2.1 备份照片

2.1.1 手动备份照片

你可以手动备份 Flickr 上的照片。通过项目的界面选择照片并进行备份操作。

2.1.2 自动备份照片

项目支持通过 Flickr 推送 Feeds 自动备份照片。你可以配置自动备份任务,定期将照片备份到本地或云存储。

2.1.3 控制谁可以备份照片

你可以控制哪些用户可以备份他们的照片。通过项目的权限设置,你可以为不同的用户设置不同的备份权限。

2.2 存储选项

2.2.1 使用本地文件系统

你可以选择将照片和元数据文件存储在本地文件系统中。这是最简单的存储方式,适合小型项目。

2.2.2 使用 Amazon S3 服务

你可以选择使用 Amazon S3 服务来存储照片和元数据文件。S3 提供了高可用性和可扩展性,适合大规模项目。

2.2.3 使用 "storagemaster" 服务

你还可以选择使用 "storagemaster" 服务来存储照片和元数据文件。这是一种自定义的存储解决方案,适合特定的需求。

2.3 高级功能

2.3.1 Solr

项目支持使用 Solr 进行全文搜索。你可以配置 Solr 来索引照片的元数据,从而实现快速搜索。

2.3.2 上传功能

项目提供了多种上传照片的方式:

  • 上传通知:上传照片后,项目可以发送通知。
  • 上传到 Flickr:你可以选择将照片上传到 Flickr。
  • 上传到 Parallel-Flickr:你也可以选择将照片上传到 Parallel-Flickr。
  • 通过 API 上传:项目提供了 API 接口,允许你通过 API 上传照片。
  • 通过电子邮件上传:你还可以通过电子邮件上传照片。

2.3.3 过滤上传

你可以配置上传过滤器,根据特定的规则过滤上传的照片。

3. 项目 API 使用文档

3.1 上传 API

项目提供了上传照片的 API 接口。你可以通过以下方式使用上传 API:

  • API 请求格式:使用 HTTP POST 请求,将照片数据作为请求体发送。
  • API 响应格式:API 返回 JSON 格式的响应,包含上传结果和照片的元数据。

3.2 备份 API

项目还提供了备份照片的 API 接口。你可以通过以下方式使用备份 API:

  • API 请求格式:使用 HTTP GET 请求,传递 Flickr 用户的 ID 和备份选项。
  • API 响应格式:API 返回 JSON 格式的响应,包含备份结果和备份的照片列表。

4. 项目安装方式

4.1 本地安装

如果你希望在本地机器上安装 parallel-flickr,可以按照以下步骤操作:

  1. 从 GitHub 下载代码。
  2. 配置 config.php 文件,设置本地数据库和 Flickr API 凭证。
  3. 在本地运行 Apache 和 MySQL 服务。
  4. 通过浏览器访问本地 URL,完成安装。

4.2 云端安装

如果你希望在云端服务器上安装 parallel-flickr,可以按照以下步骤操作:

  1. 选择一个云服务提供商(如 AWS、Google Cloud 或 Azure)。
  2. 创建一个新的虚拟机实例,并安装 Apache、PHP 和 MySQL。
  3. 从 GitHub 下载代码并上传到云端服务器。
  4. 配置 config.php 文件,设置云端数据库和 Flickr API 凭证。
  5. 通过浏览器访问云端 URL,完成安装。

通过以上步骤,你可以成功安装并使用 parallel-flickr 项目。

热门项目推荐
相关项目推荐

项目优选

收起
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
48
38
PDFMathTranslatePDFMathTranslate
PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译,支持 Google/DeepL/Ollama/OpenAI 等服务,提供 CLI/GUI/Docker
Python
31
3
open-eBackupopen-eBackup
open-eBackup是一款开源备份软件,采用集群高扩展架构,通过应用备份通用框架、并行备份等技术,为主流数据库、虚拟化、文件系统、大数据等应用提供E2E的数据备份、恢复等能力,帮助用户实现关键数据高效保护。
HTML
69
51
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
173
39
RuoYi-VueRuoYi-Vue
🎉 基于SpringBoot,Spring Security,JWT,Vue & Element 的前后端分离权限管理系统,同时提供了 Vue3 的版本
Java
165
34
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
249
63
RuoYi-Cloud-Vue3RuoYi-Cloud-Vue3
🎉 基于Spring Boot、Spring Cloud & Alibaba、Vue3 & Vite、Element Plus的分布式前后端分离微服务架构权限管理系统
Vue
25
17
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
892
0
smart-adminsmart-admin
SmartAdmin国内首个以「高质量代码」为核心,「简洁、高效、安全」中后台快速开发平台;基于SpringBoot2/3 + Sa-Token + Mybatis-Plus 和 Vue3 + Vite5 + Ant Design Vue 4.x (同时支持JavaScript和TypeScript双版本);满足国家三级等保要求、支持登录限制、接口数据国产加解密、高防SQL注入等一系列安全体系。
Java
19
3
杨帆测试平台杨帆测试平台
扬帆测试平台是一款高效、可靠的自动化测试平台,旨在帮助团队提升测试效率、降低测试成本。该平台包括用例管理、定时任务、执行记录等功能模块,支持多种类型的测试用例,目前支持API(http和grpc协议)、性能、CI调用等功能,并且可定制化,灵活满足不同场景的需求。 其中,支持批量执行、并发执行等高级功能。通过用例设置,可以设置用例的基本信息、运行配置、环境变量等,灵活控制用例的执行。
JavaScript
11
2