Популярные пользователи по языкам и регионам с Silex и Github

 { ... "autoload": { "psr-0": { "Silex": "src/" }, "psr-4": { "App\\": "App/" } }, } 

Затем запустите composer dump-autoload чтобы восстановить файлы автозагрузки. Теперь мы готовы перейти к реальной вещи!

Пользователи GitHub в локации

Первое, что нам нужно для нашего топлиста, — это получить список имен пользователей в определенном месте, которые имеют репозитории на указанном языке. Для этого мы можем использовать API поиска пользователей .

Если вы посмотрите на эту страницу, вы увидите, что мы можем указать несколько параметров при поиске пользователей. Однако нас интересует location и language , которые можно указать в параметре q . Если вы ранее использовали окно поиска GitHub, вы заметите, что параметр q — это то, что вы вводите в это текстовое поле.

Давайте продолжим и создадим сервис, который ищет пользователей, которые живут в нужном нам месте и имеют репозитории на нужном нам языке программирования. Мы назовем его UserSearcher и поместим в App/Services .

 <?php namespace App\Services; use Github\Client; class UserSearcher { /** * @var Client */ protected $client; public function __construct(Client $client) { $this->client = $client; } public function retrieveByLocationAndLanguage($location, $language) { $searchString = "location:${location} language:${language}"; $results = $this->fetchSearchResults($searchString, 10); return $this->extractUsernames($results); } protected function fetchSearchResults($searchString, $count) { $results = $this->client ->search() ->setPerPage($count) ->users($searchString, 'followers') ; return $results['items']; } protected function extractUsernames(array $results) { $usernames = []; foreach ($results as $result) { $usernames[] = $result['login']; } return $usernames; } } 

Как видите, метод UserSearcher::retrieveByLocationAndLanguage() сначала создает строку поиска. Если вы отправите Tehran и PHP в качестве первого и второго аргументов этой функции соответственно, строка будет следующим location:Tehran language:PHP .

Затем он получает список из десяти лучших результатов поиска, используя Github\Client . Как вы, вероятно, догадались, сначала он получает объект API поиска ( Github\Api\Search ) от клиента, а затем устанавливает perPage в 10, что означает, что он будет запрашивать только десять результатов поиска. После этого он отправляет строку поиска в GitHub и возвращает результаты. Обратите внимание, что результаты поиска сортируются по количеству подписчиков и по индексу элементов возвращаемого массива.

Метод extractUserNames() просто делает то, что вы ожидаете: он просматривает результаты и добавляет login каждого пользователя в массив, а затем возвращает его.

Что мы имеем на данный момент? Десять имен пользователей. Десять имен пользователей, которые мы можем запросить для их репозиториев, а затем сложить количество наблюдателей звезд для всех репозиториев под именем этого пользователя.

Готов?

Stargazers из хранилищ

Ниже приведен код для нашего класса App\Services\StarGazerCalculator :

 <?php namespace App\Services; use Github\Client; class StarGazerCalculator { /** * @var Client */ protected $client; public function __construct(Client $client) { $this->client = $client; } public function calculateStarGazersByUsername($username) { $repositories = $this->client->user()->repositories($username); $repositories = $this->filterForkedRepositories($repositories); return $this->addStarGazersFromRepositories($repositories); } protected function filterForkedRepositories(array $repositories) { return array_filter($repositories, function($repository) { return $repository['fork'] === false; }); } protected function addStarGazersFromRepositories(array $repositories) { return array_reduce($repositories, function($starGazersSoFar, $repository) { return $starGazersSoFar + $repository['stargazers_count']; }); } } 

Получение лучших авторов

Теперь пришло время начать писать наш последний класс, TopCreatorsRetriever . Этот класс объединяет функциональность, которую мы хотим — он получает десять самых популярных имен пользователей с UserSearcher класса UserSearcher , а затем перебирает этих пользователей, используя StarGazerCalculator чтобы получить количество StarGazerCalculator для каждого пользователя.

 <?php namespace App\Services; class TopCreatorsRetriever { /** * @var UserSearcher */ protected $searcher; /** * @var StarGazerCalculator */ protected $calculator; public function __construct(UserSearcher $searcher, StarGazerCalculator $calculator) { $this->searcher = $searcher; $this->calculator = $calculator; } public function retrieve($location, $language) { $usernames = $this->searcher->retrieveByLocationAndLanguage($location, $language); $map = $this->createUserStarGazerMap($usernames); return $this->sortMapByStarGazers($map); } protected function createuserStarGazerMap(array $usernames) { $results = []; foreach ($usernames as $username) { $results[$username] = $this->calculator->calculateStarGazersByUsername($username); } return $results; } protected function sortMapByStarGazers(array $map) { arsort($map, SORT_NUMERIC); return $map; } } 

Поставщик услуг

Как вы, возможно, знаете, чтобы добавить наши классы в контейнер внедрения зависимостей, поставляемый с Silex, нам нужно создать поставщика услуг, а затем зарегистрировать его в приложении . Это означает, что нам нужно создать поставщика услуг, чтобы использовать наш недавно написанный класс TopCreatorsRetriever . Нам не нужно регистрировать другие два класса, потому что эти два класса предназначены для внутреннего использования нашим высокоуровневым классом TopCreatorsRetriever .

Создайте новую папку в App/ и назовите ее Providers . Затем создайте файл с именем TopCreatorsRetrieverServiceProvider.php котором будет размещен код для нашего класса.

 <?php namespace App\Providers; use Silex\ServiceProviderInterface; use Silex\Application; use Github\Client; use App\Services\UserSearcher; use App\Services\StarGazerCalculator; use App\Services\TopCreatorsRetriever; class TopCreatorsRetrieverServiceProvider implements ServiceProviderInterface { public function register(Application $app) { $app['topCreatorsRetriever'] = $app->share(function() { $client = new Client(); $searcher = new UserSearcher($client); $calculator = new StarGazerCalculator($client); return new TopCreatorsRetriever($searcher, $calculator); }); } public function boot(Application $app) { } } 

Примечание . Не удаляйте пустую функцию boot() . Он должен существовать, даже если он пуст, чтобы наш класс соответствовал интерфейсу ServiceProviderInterface .

Использование TopCreatorsRetriever в нашем контроллере

Наконец пришло время увидеть всю нашу работу в действии. Мы определим маршрут в index.php называемый creators , который получает location и language качестве аргументов, а затем возвращает массив JSON с именами пользователей в качестве ключей и количеством звездных наблюдателей в качестве значений. Не забывайте, что, как отмечалось ранее, нам также необходимо зарегистрировать поставщика услуг, который мы создали ранее.

 <?php require_once __DIR__.'/../vendor/autoload.php'; use Silex\Application; use App\Providers\TopCreatorsRetrieverServiceProvider; $app = new Application(); $app['debug'] = true; $app->register(new TopCreatorsRetrieverServiceProvider()); $app->get('/creators/{location}/{language}', function (Application $app, $location, $language) { $data = $app['topCreatorsRetriever']->retrieve($location, $language); return $app->json($data); }); $app->run(); 

Очень просто. Единственное, что изменилось, — это регистрация нашего поставщика услуг и нашего маршрута, который содержит только две строки:

1. Первая строка получает данные из класса TopCreatorsRetriever , и
2. Вторая строка превращает эти данные в JSON.

Теперь, если вы отправите запрос по http://homestead.app:8000/creators/Tehran/PHP , вы увидите всех создателей пакетов с наибольшим количеством наблюдателей, которые живут в Тегеране:

 { "sallar":198, "sepehr":86, "reshadman":49, "moein7tl":49, "alijmlzd":13, "atkrad":4, "AmirHossein":3, "Yousha":0, "voltan":0, "zoli":0 } 

Поздравляем! Теперь вы знаете, кто самые популярные создатели пакетов в любой области!

Вывод

Теперь у нас есть приложение, которое собирает значимые данные из GitHub с помощью очень простого механизма: мы выбираем лучших пользователей в области, у которых есть репозиторий на нужном нам языке, и добавляем наблюдатели звезд для всех своих репозиториев.

Надеюсь, этот урок научил вас чему-то новому и полезному. Пожалуйста, оставьте свой отзыв в комментариях ниже, и не забудьте, что вы можете проверить полный исходный код здесь !