PHPackages pharit/tong-facebook-sdk - 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. pharit/tong-facebook-sdk ActiveLibrary[API Development](/categories/api) pharit/tong-facebook-sdk ======================== A comprehensive Facebook SDK API package for Laravel applications v1.0.0(8mo ago)01MITPHPPHP ^8.1 Since Aug 21Pushed 8mo agoCompare [ Source](https://github.com/pharit/tong-facebook-sdk)[ Packagist](https://packagist.org/packages/pharit/tong-facebook-sdk)[ RSS](/packages/pharit-tong-facebook-sdk/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (8)Versions (3)Used By (0) Tong Facebook SDK for Laravel ============================= [](#tong-facebook-sdk-for-laravel) A comprehensive Facebook SDK package for Laravel applications that provides easy integration with Facebook's Graph API, OAuth authentication, and various Facebook features. Features -------- [](#features) - ๐Ÿ” **OAuth Authentication** - Complete OAuth flow implementation - ๐Ÿ“Š **Graph API Integration** - Full access to Facebook's Graph API - ๐Ÿ‘ฅ **User Management** - Get user profiles, friends, posts, and more - ๐Ÿ“ฑ **Page Management** - Create posts, manage pages, and get insights - ๐Ÿ‘ฅ **Group Operations** - Post to groups and manage group interactions - ๐Ÿ“ธ **Media Handling** - Upload photos and manage albums - ๐ŸŽฏ **Search Functionality** - Search for users, pages, groups, and events - ๐Ÿ“ˆ **Analytics** - Get insights and analytics data - ๐Ÿ›ก๏ธ **Error Handling** - Comprehensive error handling with custom exceptions - ๐Ÿ“ **Logging** - Built-in request/response logging - ๐Ÿ’พ **Caching** - Automatic caching for improved performance - ๐Ÿงช **Testing** - Full test suite with PHPUnit Requirements ------------ [](#requirements) - PHP 8.1 or higher - Laravel 10.x or 11.x - GuzzleHTTP 7.0 or higher Installation ------------ [](#installation) 1. **Install the package via Composer:** ``` composer require pharit/tong-facebook-sdk ``` 2. **Publish the configuration file:** ``` php artisan vendor:publish --provider="Tong\FacebookSdk\FacebookSdkServiceProvider" --tag="facebook-sdk-config" ``` 3. **Add your Facebook App credentials to your `.env` file:** ``` FACEBOOK_APP_ID=your_facebook_app_id FACEBOOK_APP_SECRET=your_facebook_app_secret FACEBOOK_GRAPH_VERSION=v18.0 FACEBOOK_REDIRECT_URI=https://your-domain.com/facebook/callback ``` Configuration ------------- [](#configuration) The configuration file `config/facebook-sdk.php` contains all the settings for the Facebook SDK: ``` return [ 'app_id' => env('FACEBOOK_APP_ID', ''), 'app_secret' => env('FACEBOOK_APP_SECRET', ''), 'default_graph_version' => env('FACEBOOK_GRAPH_VERSION', 'v18.0'), 'graph_url' => 'https://graph.facebook.com', 'oauth_url' => 'https://www.facebook.com/dialog/oauth', 'default_permissions' => ['public_profile', 'email'], 'redirect_uri' => env('FACEBOOK_REDIRECT_URI', ''), 'http' => [ 'timeout' => 30, 'connect_timeout' => 10, 'verify' => true, ], 'logging' => [ 'enabled' => env('FACEBOOK_LOGGING_ENABLED', false), 'channel' => env('FACEBOOK_LOGGING_CHANNEL', 'stack'), ], 'cache' => [ 'enabled' => env('FACEBOOK_CACHE_ENABLED', true), 'ttl' => env('FACEBOOK_CACHE_TTL', 3600), ], ]; ``` Usage ----- [](#usage) ### Basic Usage [](#basic-usage) #### Using the Facade [](#using-the-facade) ``` use Tong\FacebookSdk\Facades\Facebook; // Get user profile $userProfile = Facebook::get('me', ['access_token' => $accessToken]); // Create a post $post = Facebook::post('me/feed', [ 'access_token' => $accessToken, 'message' => 'Hello from Laravel!' ]); ``` #### Using Dependency Injection [](#using-dependency-injection) ``` use Tong\FacebookSdk\Services\FacebookService; use Tong\FacebookSdk\Services\FacebookAuthService; use Tong\FacebookSdk\Services\FacebookGraphService; class FacebookController extends Controller { public function __construct( private FacebookService $facebookService, private FacebookAuthService $authService, private FacebookGraphService $graphService ) {} public function login() { $loginUrl = $this->authService->getLoginUrl(['public_profile', 'email']); return redirect($loginUrl); } public function callback(Request $request) { $code = $request->get('code'); $tokenData = $this->authService->getAccessTokenFromCode($code); $user = $this->authService->getUser($tokenData['access_token']); return response()->json($user); } } ``` ### Authentication [](#authentication) #### OAuth Login Flow [](#oauth-login-flow) ``` // 1. Generate login URL $loginUrl = app(FacebookAuthService::class)->getLoginUrl([ 'public_profile', 'email', 'user_posts' ]); // 2. Redirect user to Facebook return redirect($loginUrl); // 3. Handle callback public function handleCallback(Request $request) { $code = $request->get('code'); $tokenData = app(FacebookAuthService::class)->getAccessTokenFromCode($code); // Store the access token $accessToken = $tokenData['access_token']; // Get user information $user = app(FacebookAuthService::class)->getUser($accessToken); return response()->json($user); } ``` #### Token Management [](#token-management) ``` $authService = app(FacebookAuthService::class); // Debug token information $tokenInfo = $authService->debugToken($accessToken); // Extend short-lived token to long-lived $longLivedToken = $authService->extendToken($accessToken); // Get user permissions $permissions = $authService->getUserPermissions($accessToken); // Revoke permissions $authService->revokePermissions($accessToken, ['email']); ``` ### Graph API Operations [](#graph-api-operations) #### User Operations [](#user-operations) ``` $graphService = app(FacebookGraphService::class); // Get user profile $profile = $graphService->getUserProfile($accessToken, [ 'id', 'name', 'email', 'picture' ]); // Get user posts $posts = $graphService->getUserPosts($accessToken, [ 'id', 'message', 'created_time' ], 10); // Create a post $post = $graphService->createPost($accessToken, 'Hello from Laravel!'); // Get user friends $friends = $graphService->getUserFriends($accessToken, ['id', 'name']); ``` #### Media Operations [](#media-operations) ``` // Get user photos $photos = $graphService->getUserPhotos($accessToken, [ 'id', 'source', 'created_time' ]); // Upload a photo $photo = $graphService->uploadPhoto( $accessToken, 'https://example.com/image.jpg', 'My awesome photo!' ); // Get user albums $albums = $graphService->getUserAlbums($accessToken, [ 'id', 'name', 'description' ]); // Create an album $album = $graphService->createAlbum( $accessToken, 'My Vacation Photos', 'Photos from my recent vacation' ); ``` #### Page Operations [](#page-operations) ``` // Get user's pages $pages = $graphService->getUserPages($accessToken, [ 'id', 'name', 'access_token' ]); // Get page information $page = $graphService->getPage($pageId, $pageAccessToken, [ 'id', 'name', 'fan_count', 'category' ]); // Create a post on a page $pagePost = $graphService->createPagePost( $pageId, $pageAccessToken, 'Hello from our page!' ); ``` #### Group Operations [](#group-operations) ``` // Get user's groups $groups = $graphService->getUserGroups($accessToken, [ 'id', 'name', 'privacy' ]); // Get group information $group = $graphService->getGroup($groupId, $accessToken, [ 'id', 'name', 'description', 'member_count' ]); // Create a post in a group $groupPost = $graphService->createGroupPost( $groupId, $accessToken, 'Hello group members!' ); ``` #### Social Interactions [](#social-interactions) ``` // Get comments on a post $comments = $graphService->getComments($postId, $accessToken, [ 'id', 'message', 'from', 'created_time' ]); // Add a comment $comment = $graphService->addComment($postId, $accessToken, 'Great post!'); // Get likes on a post $likes = $graphService->getLikes($postId, $accessToken, [ 'id', 'name' ]); // Like a post $graphService->likePost($postId, $accessToken); // Unlike a post $graphService->unlikePost($postId, $accessToken); ``` #### Search and Analytics [](#search-and-analytics) ``` // Search for users $users = $graphService->search('John Doe', 'user', $accessToken, [ 'id', 'name', 'picture' ]); // Search for pages $pages = $graphService->search('Laravel', 'page', $accessToken, [ 'id', 'name', 'category' ]); // Get insights for a page $insights = $graphService->getInsights($pageId, $pageAccessToken, [ 'page_impressions', 'page_engaged_users' ], 'day'); ``` ### Error Handling [](#error-handling) The package provides comprehensive error handling with custom exceptions: ``` use Tong\FacebookSdk\Exceptions\FacebookApiException; try { $user = $graphService->getUserProfile($accessToken); } catch (FacebookApiException $e) { if ($e->isInvalidToken()) { // Handle invalid token return redirect()->route('facebook.login'); } if ($e->isInsufficientPermissions()) { // Handle insufficient permissions return response()->json(['error' => 'Insufficient permissions'], 403); } if ($e->isRateLimited()) { // Handle rate limiting return response()->json(['error' => 'Rate limited'], 429); } // Handle other errors return response()->json(['error' => $e->getMessage()], 500); } ``` ### Caching [](#caching) The package includes automatic caching for GET requests: ``` // Enable caching in config 'cache' => [ 'enabled' => true, 'ttl' => 3600, // 1 hour ], // Cache is automatically used for GET requests $userProfile = $graphService->getUserProfile($accessToken); // Cached $posts = $graphService->getUserPosts($accessToken); // Cached ``` ### Logging [](#logging) Enable logging to track API requests and responses: ``` // Enable logging in config 'logging' => [ 'enabled' => true, 'channel' => 'stack', ], // Logs will be written to the specified channel // You can view them in your Laravel logs ``` Testing ------- [](#testing) Run the test suite: ``` composer test ``` Or run with coverage: ``` composer test -- --coverage ``` Contributing ------------ [](#contributing) 1. Fork the repository 2. Create a feature branch 3. Make your changes 4. Add tests for new functionality 5. Run the test suite 6. Submit a pull request License ------- [](#license) This package is open-sourced software licensed under the [MIT license](LICENSE). Support ------- [](#support) If you encounter any issues or have questions, please open an issue on GitHub. Changelog --------- [](#changelog) ### 1.0.0 [](#100) - Initial release - OAuth authentication - Graph API integration - User, page, and group operations - Media handling - Search functionality - Analytics and insights - Error handling and logging - Caching support - Comprehensive test suite ### Health Score 30 โ€” LowBetter than 64% of packages Maintenance62 Regular maintenance activity Popularity1 Limited adoption so far Community6 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits โ€” single point of failure 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. ### Release Activity Cadence Unknown Total 1 Last Release 261d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/6e77c782ff0f62adfdba67ff4a5893ffc5c7afb9cf30154ac87679cc3b19cb9e?d=identicon)[nkaajtooj](/maintainers/nkaajtooj) --- Top Contributors [![pharit](https://avatars.githubusercontent.com/u/22044407?v=4)](https://github.com/pharit "pharit (3 commits)") ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/pharit-tong-facebook-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/pharit-tong-facebook-sdk/health.svg)](https://phpackages.com/packages/pharit-tong-facebook-sdk) ``` ### Alternatives [skagarwal/google-places-api Google Places Api 1913.0M8](/packages/skagarwal-google-places-api)[jasara/php-amzn-selling-partner-api A fluent interface for Amazon's Selling Partner API in PHP 1344.8k1](/packages/jasara-php-amzn-selling-partner-api)[grantholle/powerschool-api A Laravel package to make interacting with PowerSchool less painful. 1715.6k1](/packages/grantholle-powerschool-api) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)