PHPackages dailymotion/cloudkey-php - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. dailymotion/cloudkey-php ActiveLibrary[API Development](/categories/api) dailymotion/cloudkey-php ======================== Dailymotion Cloud API PHP bindings 2921.9k24[6 issues](https://github.com/dailymotion/cloudkey-php/issues)PHP Since Feb 15Pushed 1y ago88 watchersCompare [ Source](https://github.com/dailymotion/cloudkey-php)[ Packagist](https://packagist.org/packages/dailymotion/cloudkey-php)[ RSS](/packages/dailymotion-cloudkey-php/feed)WikiDiscussions master Synced yesterday READMEChangelogDependenciesVersions (2)Used By (0) Remote methods ============== [](#remote-methods) The Dailymotion Cloud API PHP binding exposes all API methods described in the API reference. A master class named `CloudKey` exposes all namespaces through object attributes. For instance, a call to the `count` method in the `media` namespace would be as follow: ``` $cloudkey = new CloudKey($user_id, $api_key); $result = $cloudkey->media->count(); ``` For methods expecting parameters, these must be passed as an associative array: ``` $media = $cloudkey->media->info(array('id' => $a_media_id)); ``` The returned values (when available) are either `stdClass` instances (when result is a structure) or arrays of `stdClass` instances (when result is a list of structures): ``` # Simple structure response $media = $cloudkey->media->info(array('id' => $a_media_id)); echo $media->id; # List of structures response $page = 1; while(1) { $res = $cloudkey->media->list(array('fields' => array('id', 'meta.title'), 'page' => $page++)); foreach($res->list as $media) { printf("%s %s\n", $media->id, $media->meta->title); } if ($res->page == $res->pages) { break; } } ``` Local methods ============= [](#local-methods) Additional local methods are exposed by the CloudKey class. They are not documented in the API reference and provided as helpers to ease the Dailymotion Cloud API integration. `file->upload_file($path)` -------------------------- [](#file-upload_filepath) This method manages files uploads to the Dailymotion Cloud upload servers. Information pertinent to the API media creation processus will be returned as a `dict`. Arguments: - `$path`: (required) the path of the uploaded file. Example: ``` # source asset upload example $file = $cloudkey->file->upload_file('path/to/video.mov'); # The list of encoding assets that we want $assets = array('mp4_h264_aac', 'mp4_h264_aac_hq', 'jpeg_thumbnail_medium', 'jpeg_thumbnail_source'); # Metadata $meta = array('title' => 'My video', 'author' => 'Author'); $media = $cloudkey->media->create(array('assets_names' => $assets, 'meta' => $meta, 'url' => $file->url)); ``` `media.get_embed_url(id)` ------------------------- [](#mediaget_embed_urlid) This method returns a signed URL to a Dailymotion Cloud player embed (see the API reference for details). The generated URL is perishable, and access is granted based on the provided security level bitmask. Arguments: - `id`: (required) the media id. - `seclevel`: the security level bitmask (default is `CLOUDKEY_SECLEVEL_NONE`, see below for details). - `expires`: the UNIX epoch expiration time (default is `time() + 7200` (2 hours from now)). - `secure`: `true` to get the https embed url (default is `false`). The following arguments may be required if the `CLOUDKEY_SECLEVEL_DELEGATE` option is not specified in the seclevel parameter, depending on the other options. This is not recommanded as it would probably lead to spurious access denials, mainly due to GeoIP databases discrepancies. - `asnum`: the client's autonomous system number (default is `None`). - `ip`: the client's IP adress (default is `None`). - `useragent`: the client's HTTP User-Agent header (default is `None`). Example: ``` // Create an embed URL limited only to the AS of the end-user and valid for 1 hour $url = $cloudkey->media->get_embed_url(array('id' => $media->id, 'seclevel' => CLOUDKEY_SECLEVEL_DELEGATE | CLOUDKEY_SECLEVEL_ASNUM, 'expires' => time() + 3600)); ``` `media.get_stream_url(id)` -------------------------- [](#mediaget_stream_urlid) This method returns a signed URL to a Dailymotion Cloud video stream (see the API reference for details). The generated URL is perishable, and access is granted based on the provided security level bitmask. Arguments: - `id`: (required) the media id. - `asset_name`: the desired media asset asset\_name name (default is `mp4_h264_aac`). - `seclevel`: the security level bitmask (default is `CLOUDKEY_SECLEVEL_NONE`, see below for details). - `expires`: the UNIX epoch expiration time (default is `time() + 7200` (2 hours from now)). - `download`: `True` to get the download url (default is `False`). - `filename`: the download url filename (overrides the `download` parameter if set). - `version`: arbitrary integer inserted in the url for the cache flush. Use this parameter only if needed, and change its value only when a cache flush is required. - `protocol`: streaming protocol ('hls', 'rtmp', 'hps' or 'http'). Overrides the `download` parameter if 'http'. The following arguments may be required if the `CLOUDKEY_SECLEVEL_DELEGATE` option is not specified in the seclevel parameter, depending on the other options. This is not recommanded as it would probably lead to spurious access denials, mainly due to GeoIP databases discrepancies. - `asnum`: the client's autonomous system number (default is `None`). - `ip`: the client's IP adress (default is `None`). - `useragent`: the client's HTTP User-Agent header (default is `None`). Example: ``` // Create a stream URL limited only to the AS of the end-user and valid for 1 hour url = cloudkey.media.get_stream_url(id=media['id'], seclevel=CLOUDKEY_SECLEVEL_DELEGATE | CLOUDKEY_SECLEVEL_ASNUM, expires=time() + 3600) $url = $cloudkey->media->get_stream_url(array('id' => $media->id, 'seclevel' => CLOUDKEY_SECLEVEL_DELEGATE | CLOUDKEY_SECLEVEL_ASNUM, 'expires' => time() + 3600)); ``` Security level options ====================== [](#security-level-options) The security level defines the mechanism used by the Dailymotion Cloud architecture to ensure a mediastream URL access will be limited to a single user or a group of users. The different (combinable) options are: - `CLOUDKEY_SECLEVEL_NONE`: the URL access is granted to everyone. - `CLOUDKEY_SECLEVEL_ASNUM`: the URL access is granted to the specified AS number only. AS numbers stands for 'Autonomous System number' and roughly map groups of IP to telcos and large organizations on the Internet (each ISP has its own AS number for instance, Dailyotion's AS number is AS41690). - `CLOUDKEY_SECLEVEL_IP`: the URL access is granted to the specified IP address only. This option may lead to spurious access denials as some users are load-balanced behind multiple proxies when accessing the Internet (this is mostly the case with ISPs and large organizations). - `CLOUDKEY_SECLEVEL_USERAGENT`: the URL access is granted to users sending the specified User-Agent HTTP header only. - `CLOUDKEY_SECLEVEL_DELEGATE`: the ASNUM, IP and User-Agent values are to be gathered at the server side during the first URL access and don't need to be specified at the client side beforehand (this is the recommanded approach as it will ensure a 100%-accurate ASNUM recognition). - `CLOUDKEY_SECLEVEL_USEONCE`: the URL access is granted once only (using this option will probably prevent seeking from working correctly). For more information, please refer to the Dailymotion Cloud streams security documentation. Exceptions ========== [](#exceptions) The Dailymotion Cloud API methods may throw exceptions when errors occur, and they should be catched in your code. The available exceptions are: - `CloudKey_Exception`: an unexpected API response occured. - `CloudKey_ProtocolException`: a transport layer error occured. - `CloudKey_InvalidNamespaceException`: an invalid namespace was used. - `CloudKey_InvalidMethodException`: an invalid method was called. - `CloudKey_NotFoundException`: an action was requested on an invalid item. - `CloudKey_MissingParamException`: a mandatory parameter was missing from a method call. - `CloudKey_InvalidParamException`: an invalid parameter was specified in a method call. - `CloudKey_AuthorizationRequiredException`: an authenticated method was call but no authentication information was provided. - `CloudKey_AuthenticationFailedException`: invalid authentication information was provided. ### Health Score 33 — LowBetter than 72% of packages Maintenance23 Infrequent updates — may be unmaintained Popularity34 Limited adoption so far Community30 Small or concentrated contributor base Maturity43 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/b9879344bfe2945ba8de0f608c5232f23a931d700390ee48e27c658d34a62fa0?d=identicon)[rs](/maintainers/rs) ![](https://www.gravatar.com/avatar/ed46a64c814a2e1e7f315268e4afc29bf4bb34e6f4e4e9d2af98bd938b917dec?d=identicon)[nyvath](/maintainers/nyvath) ![](https://www.gravatar.com/avatar/5abf7849ce68f367a8da78e0956b938c5cee552413ee4660029ebd92a28ed062?d=identicon)[mgillot](/maintainers/mgillot) --- Top Contributors [![sebest](https://avatars.githubusercontent.com/u/115339?v=4)](https://github.com/sebest "sebest (17 commits)")[![jererc](https://avatars.githubusercontent.com/u/871873?v=4)](https://github.com/jererc "jererc (11 commits)")[![gi-lunaweb](https://avatars.githubusercontent.com/u/218932?v=4)](https://github.com/gi-lunaweb "gi-lunaweb (7 commits)")[![pyke369](https://avatars.githubusercontent.com/u/115323?v=4)](https://github.com/pyke369 "pyke369 (4 commits)")[![nyvath](https://avatars.githubusercontent.com/u/136798?v=4)](https://github.com/nyvath "nyvath (2 commits)")[![simongeorges](https://avatars.githubusercontent.com/u/546691?v=4)](https://github.com/simongeorges "simongeorges (2 commits)")[![belevian](https://avatars.githubusercontent.com/u/274320?v=4)](https://github.com/belevian "belevian (1 commits)")[![yanncoupin](https://avatars.githubusercontent.com/u/209176?v=4)](https://github.com/yanncoupin "yanncoupin (1 commits)")[![codingstyle](https://avatars.githubusercontent.com/u/974424?v=4)](https://github.com/codingstyle "codingstyle (1 commits)")[![dland](https://avatars.githubusercontent.com/u/52325?v=4)](https://github.com/dland "dland (1 commits)")[![dm-renovate[bot]](https://avatars.githubusercontent.com/u/115313?v=4)](https://github.com/dm-renovate[bot] "dm-renovate[bot] (1 commits)")[![fabpot](https://avatars.githubusercontent.com/u/47313?v=4)](https://github.com/fabpot "fabpot (1 commits)")[![spyrospph](https://avatars.githubusercontent.com/u/714938?v=4)](https://github.com/spyrospph "spyrospph (1 commits)") ### Embed Badge ![Health badge](/badges/dailymotion-cloudkey-php/health.svg) ``` [![Health](https://phpackages.com/badges/dailymotion-cloudkey-php/health.svg)](https://phpackages.com/packages/dailymotion-cloudkey-php) ``` ### Alternatives [exsyst/swagger A php library to manipulate Swagger specifications 35916.4M7](/packages/exsyst-swagger)[hubspot/api-client Hubspot API client 24016.2M20](/packages/hubspot-api-client)[pocketmine/bedrock-protocol An implementation of the Minecraft: Bedrock Edition protocol in PHP 172445.0k15](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram Telegram driver for BotMan 93459.5k6](/packages/botman-driver-telegram) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)