Service/Flickr.php
Zend Framework
LICENSE
This source file is subject to the new BSD license that is bundled
with this package in the file LICENSE.txt.
It is also available through the world-wide-web at this URL:
http://framework.zend.com/license/new-bsd
If you did not receive a copy of the license and are unable to
obtain it through the world-wide-web, please send an email
to license@zend.com so we can send you a copy immediately.
- Category
- Zend
- Copyright
- Copyright (c) 2005-2014 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
- Package
- Zend_Service
- Subpackage
- Flickr
- Version
- $Id$
Package: Zend_Service\Flickr- Category
- Zend
- Copyright
- Copyright (c) 2005-2014 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
Constants
URI_BASE
= 'http://www.flickr.com'
Base URI for the REST client
Properties
Methods
__construct(string $apiKey) : void
Performs object initializations
# Sets up character encoding
# Saves the API key
ParametersName | Type | Description |
---|
$apiKey | string | Your Flickr API key |
---|
_compareOptions(array $options, array $validOptions) : void
Throws an exception if and only if any user options are invalid
ParametersName | Type | Description |
---|
$options | array | User options |
---|
$validOptions | array | Valid options |
---|
Throws _prepareOptions(string $method, array $options, array $defaultOptions) : array
Prepare options for the request
ParametersName | Type | Description |
---|
$method | string | Flickr Method to call |
---|
$options | array | User Options |
---|
$defaultOptions | array | Default Options |
---|
ReturnsType | Description |
---|
array | Merged array of user and default/required options |
_validateGroupPoolGetPhotos(array $options) : void
Validate Group Search Options
ParametersName | Type | Description |
---|
$options | array | |
---|
Throws _validateTagSearch(array $options) : void
Validate Tag Search Options
ParametersName | Type | Description |
---|
$options | array | |
---|
Throws _validateUserSearch(array $options) : void
Validate User Search Options
ParametersName | Type | Description |
---|
$options | array | |
---|
Throws getIdByEmail(string $email) : string
Utility function to find Flickr User IDs for emails.
(You can only find a user's photo with their NSID.)
ParametersName | Type | Description |
---|
$email | string | the email |
---|
ReturnsType | Description |
---|
string | the NSID (userid) |
ThrowsgetIdByUsername(string $username) : string
Utility function to find Flickr User IDs for usernames.
(You can only find a user's photo with their NSID.)
ParametersName | Type | Description |
---|
$username | string | the username |
---|
ReturnsType | Description |
---|
string | the NSID (userid) |
ThrowsgetImageDetails(string $id) : array
Returns Flickr photo details by for the given photo ID
ParametersName | Type | Description |
---|
$id | string | the NSID |
---|
ReturnsType | Description |
---|
array | of Zend_Service_Flickr_Image, details for the specified image |
Throws groupPoolGetPhotos(string $query, array $options = array()) : \Zend_Service_Flickr_ResultSet
Finds photos in a group's pool.
ParametersName | Type | Description |
---|
$query | string | group id |
---|
$options | array | Additional parameters to refine your query. |
---|
ReturnsThrows tagSearch(string | array $query, array $options = array()) : \Zend_Service_Flickr_ResultSet
Find Flickr photos by tag.
Query options include:
# per_page: how many results to return per query
# page: the starting page offset. first result will be (page - 1) * per_page + 1
# tag_mode: Either 'any' for an OR combination of tags,
or 'all' for an AND combination. Default is 'any'.
# min_upload_date: Minimum upload date to search on. Date should be a unix timestamp.
# max_upload_date: Maximum upload date to search on. Date should be a unix timestamp.
# min_taken_date: Minimum upload date to search on. Date should be a MySQL datetime.
# max_taken_date: Maximum upload date to search on. Date should be a MySQL datetime.
ParametersName | Type | Description |
---|
$query | string | array | A single tag or an array of tags. |
---|
$options | array | Additional parameters to refine your query. |
---|
ReturnsThrowsuserSearch(string $query, array $options = null) : \Zend_Service_Flickr_ResultSet
Finds photos by a user's username or email.
Additional query options include:
# per_page: how many results to return per query
# page: the starting page offset. first result will be (page - 1) * per_page + 1
# min_upload_date: Minimum upload date to search on. Date should be a unix timestamp.
# max_upload_date: Maximum upload date to search on. Date should be a unix timestamp.
# min_taken_date: Minimum upload date to search on. Date should be a MySQL datetime.
# max_taken_date: Maximum upload date to search on. Date should be a MySQL datetime.
ParametersName | Type | Description |
---|
$query | string | username or email |
---|
$options | array | Additional parameters to refine your query. |
---|
ReturnsThrows