{"id":13520161,"url":"https://github.com/meemalabs/meema-client-php","last_synced_at":"2026-02-26T08:02:10.509Z","repository":{"id":38100423,"uuid":"339600354","full_name":"meemalabs/meema-client-php","owner":"meemalabs","description":"⚡️ A fully-featured \u0026 blazing-fast PHP API client to interact with all of Meema's functionalities. 🐑","archived":false,"fork":false,"pushed_at":"2022-08-29T10:12:18.000Z","size":315,"stargazers_count":5,"open_issues_count":5,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-08-02T05:22:54.890Z","etag":null,"topics":["image-editing","media","media-management","meema-api","meema-client-php","php","video-converter","video-streaming"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/meemalabs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null}},"created_at":"2021-02-17T03:26:11.000Z","updated_at":"2022-12-27T16:17:51.000Z","dependencies_parsed_at":"2022-08-18T13:20:24.676Z","dependency_job_id":null,"html_url":"https://github.com/meemalabs/meema-client-php","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meemalabs%2Fmeema-client-php","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meemalabs%2Fmeema-client-php/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meemalabs%2Fmeema-client-php/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meemalabs%2Fmeema-client-php/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/meemalabs","download_url":"https://codeload.github.com/meemalabs/meema-client-php/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222670691,"owners_count":17020513,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["image-editing","media","media-management","meema-api","meema-client-php","php","video-converter","video-streaming"],"created_at":"2024-08-01T05:02:13.024Z","updated_at":"2025-10-10T11:09:06.292Z","avatar_url":"https://github.com/meemalabs.png","language":"PHP","funding_links":[],"categories":["PHP"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://meema.io\"\u003e\n    \u003cimg alt=\"Meema for PHP\" src=\"https://raw.githubusercontent.com/meema/meemasearch-client-common/master/banners/php.png\" \u003e\n  \u003c/a\u003e\n\n\u003ch4 align=\"center\"\u003eThe most simple way to integrate \u003ca href=\"https://meema.io\" target=\"_blank\"\u003eMeema\u003c/a\u003e and your PHP project\u003c/h4\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://scrutinizer-ci.com/g/meemalabs/meema-client-php/badges/quality-score.png?b=main\"\u003e\u003cimg src=\"https://scrutinizer-ci.com/g/meemalabs/meema-client-php/badges/quality-score.png?b=main\" alt=\"Scrutinizer\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://packagist.org/packages/meema/meema-client-php\"\u003e\u003cimg src=\"https://poser.pugx.org/meema/meema-client-php/d/total.svg\" alt=\"Total Downloads\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://packagist.org/packages/meema/meema-client-php\"\u003e\u003cimg src=\"https://poser.pugx.org/meema/meema-client-php/v/stable.svg\" alt=\"Latest Version\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://packagist.org/packages/meema/meema-client-php\"\u003e\u003cimg src=\"https://poser.pugx.org/meema/meema-client-php/license.svg\" alt=\"License\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://www.meema.com/doc/api-client/getting-started/install/php/\" target=\"_blank\"\u003eDocumentation\u003c/a\u003e  •\n    \u003ca href=\"https://github.com/meemalabs/laravel-meema\" target=\"_blank\"\u003eLaravel\u003c/a\u003e  •\n    \u003ca href=\"https://github.com/meemalabs/meema-client-php/issues\" target=\"_blank\"\u003eReport a bug\u003c/a\u003e  •\n    \u003ca href=\"https://docs.meema.io\" target=\"_blank\"\u003eFAQ\u003c/a\u003e  •\n    \u003ca href=\"https://discord.meema.io\" target=\"_blank\"\u003eDiscord\u003c/a\u003e\n\u003c/p\u003e\n\n## 🐙 Features\n\n- Most simple way to implement a fully-functional media management system\n- Thin \u0026 minimal package to interact with Meema's API\n- Supports PHP `^7.*`\n\n## 💡 Usage\n\nFirst, install Meema PHP API Client via the [composer](https://getcomposer.org/) package manager:\n\n```bash\ncomposer require meema/meema-client-php\n```\n\nThen, initialize the Client\n\n```php\nuse Meema\\MeemaClient\\Client\n\n$client = new Client($meemaApiKey);\n```\n\nUsing the `Media` model\n\n```php\n$client-\u003emedia()-\u003ecreate('New media name');\n$client-\u003emedia()-\u003eget();\n\n// specific uuids\n$client-\u003emedia()-\u003eget('11a283ed-a64e-424a-aefc-6aa98971d529', '1556fcb8-693e-4431-8b16-3b2b7bb8fcc7');\n$client-\u003emedia()-\u003esearch('media-name');\n\n// this will return a Response instance\n$media = $client-\u003emedia()-\u003efind('11a283ed-a64e-424a-aefc-6aa98971d529');\n\n// you may chain other methods that require an id\n$media-\u003eupdate('updated-media-name')\n$media-\u003edelete();\n$media-\u003earchive();\n$media-\u003eunarchive();\n$media-\u003emakePrivate();\n$media-\u003emakePublic();\n$media-\u003eduplicate();\n\n// Relationships with other models.\n// Continuing with the chaining of methods we used earlier.\n$media-\u003efolders()-\u003eget();\n$media-\u003efolders()-\u003ecreate('New folder name');\n$media-\u003efolders()-\u003edelete('11a283ed-a64e-424a-aefc-6aa98971d529');\n$media-\u003etags()-\u003eget();\n$media-\u003etags()-\u003eassociate(['name' =\u003e 'Tag Name']);\n$media-\u003etags()-\u003edisassociate(['name' =\u003e 'Tag Name']);\n```\n\nUsing the `Folder` model\n\n```php\n$client-\u003efolders()-\u003ecreate('New folder name');\n$client-\u003efolders()-\u003eget();\n\n// specific uuids\n$client-\u003efolders()-\u003eget('11a283ed-a64e-424a-aefc-6aa98971d529', '1556fcb8-693e-4431-8b16-3b2b7bb8fcc7');\n$client-\u003efolders()-\u003esearch('folder-name');\n\n// this will return a Response instance\n$folder = $client-\u003efolders()-\u003efind('11a283ed-a64e-424a-aefc-6aa98971d529');\n\n// you may chain other methods that require an id\n$folder-\u003eupdate('updated-folder-name')\n$folder-\u003edelete();\n$folder-\u003earchive();\n$folder-\u003eunarchive();\n$folder-\u003eduplicate();\n\n// Relationships with other models.\n// Continuing with the chaining of methods we used earlier.\n$folder-\u003emedia()-\u003eget();\n$folder-\u003etags()-\u003eget();\n$folder-\u003etags()-\u003eassociate(['tag_id' =\u003e 7]);\n$folder-\u003etags()-\u003edisassociate(['tag_id' =\u003e 7]);\n```\n\nUsing the `Tag` model\n\n```php\n$client-\u003etags()-\u003eget();\n\n// Specific ids\n$client-\u003etags()-\u003eget(1, 2, 3);\n\n// This will return a Response instance\n$tag = $client-\u003etags()-\u003efind(1);\n\n// you may chain other methods that require an id\n$tag-\u003eupdate('red-500'); // You will have to use tailwind CSS color palletes.\n$tag-\u003edelete();\n$tag-\u003emedia()-\u003eget();\n```\n\nUsing the `Favorite` model\n\n```php\n$client-\u003efavorites()-\u003ecreate(['name' =\u003e 'New Favorite Name', 'icon' =\u003e 'favorite-icon']);\n$client-\u003efavorites()-\u003eget();\n\n// specific ids\n$client-\u003efavorites()-\u003eget(1,2,3);\n\n// this will return a Response instance\n$favorite = $client-\u003efavorites()-\u003efind(1);\n\n// you may chain other methods that require an id\n$favorite-\u003eupdate(['name' =\u003e 'Updated Favorite Name', 'icon' =\u003e 'updated-favorite-icon']);\n$favorite-\u003edelete();\n```\n\nUsing the `Storage` model\n\n```php\n$client-\u003estorage()-\u003eupload('path/to/local/media/file');\n$client-\u003estorage()-\u003egetMetadata('meema/path/to/file.jpg');\n\n$client-\u003estorage()-\u003esetVisibility('meema/path/to/file.jpg', 'private'); // Or 'public'\n$client-\u003estorage()-\u003ehas('meema/path/to/file.jpg');\n$client-\u003estorage()-\u003edelete('meema/path/to/file.jpg');\n$client-\u003estorage()-\u003ecopy('meema/path/to/file.jpg', 'meema/path/to/copied-file.jpg');\n$client-\u003estorage()-\u003erename('meema/path/to/file.jpg', 'meema/path/to/renamed-file.jpg');\n\n$client-\u003estorage()-\u003elistContents('meema/path');\n$client-\u003estorage()-\u003emakeDirectory('meema/path/new-folder');\n```\n\nIn order to use any of our \"On-The-Fly\" image \u0026 video operations, read more **[here](https://docs.meema.io/on-the-fly)**\n\nFor the full documentation, visit the **[Meema PHP API Client](https://docs.meema.io/open-source/)**.\n\n## 🧪 Testing\n\n``` bash\ncomposer test\n```\n\n## 📈 Changelog\n\nPlease see our [releases](https://github.com/meemalabs/meema-client-php/releases) page for more information on what has changed recently.\n\n## 💪🏼 Contributing\n\nPlease see [CONTRIBUTING](CONTRIBUTING.md) for details.\n\n## 🏝 Community\n\nFor help, discussion about best practices, or any other conversation that would benefit from being searchable:\n\n[Meema PHP on GitHub](https://github.com/meemalabs/meema-client-php/discussions)\n\nFor casual chit-chat with others using this package:\n\n[Join the Meema Discord Server](https://discord.meema.io)\n\n## 🚨 Security\n\nPlease review [our security policy](https://github.com/meemalabs/meema-client-php/security/policy) on how to report security vulnerabilities.\n\n## 🙏🏼 Credits\n\n- [Chris Breuer](https://github.com/Chris1904)\n- [Folks at Meema](https://github.com/meemalabs)\n- [All Contributors](../../contributors)\n\n## 📄 License\n\nThe MIT License (MIT). Please see [LICENSE](LICENSE.md) for more information.\n\nMade with ❤️ by Meema, Inc.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeemalabs%2Fmeema-client-php","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmeemalabs%2Fmeema-client-php","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeemalabs%2Fmeema-client-php/lists"}