PHPackages danydevco/rocket - 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. [Utility & Helpers](/categories/utility) 4. / 5. danydevco/rocket ActiveLibrary[Utility & Helpers](/categories/utility) danydevco/rocket ================ v1.9.0(1y ago)06MITCSS Since Aug 23Pushed 1y ago1 watchersCompare [ Source](https://github.com/danydevco/rocket)[ Packagist](https://packagist.org/packages/danydevco/rocket)[ RSS](/packages/danydevco-rocket/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (7)Dependencies (4)Versions (53)Used By (0) About Rocket ------------ [](#about-rocket) Rocket es la herramienta definitiva para comenzar tus proyectos de desarrollo de manera rápida y efectiva. Hemos diseñado este paquete con el propósito de acelerar tus inicios de proyecto, proporcionándote todas las bases necesarias para que puedas concentrarte en construir características sorprendentes en lugar de lidiar con la configuración inicial repetitiva. - **Valores y Parámetros Pre-Configurados:** Olvídate de definir constantemente los mismos valores y parámetros en cada proyecto. Con Rocket, puedes configurar rápidamente los valores y parámetros esenciales según tus preferencias y estándares. - **Gestión de Permisos Simplificada:** Implementa un sólido sistema de control de acceso en cuestión de minutos. Rocket integra automáticamente funcionalidades de permisos y roles para que puedas asegurar tus aplicaciones de manera eficiente. - **Datos Geográficos Listos para Usar:** Ahorra tiempo al incluir una lista completa de países, ciudades y departamentos predefinidos. Nunca más tendrás que buscar e ingresar manualmente esta información básica.- Laravel is accessible, powerful, and provides tools required for large, robust applications. Instalación ----------- [](#instalación) ``` composer require Danydevco/rocket ``` Una vez que se haya instalado el paquete, debes ejecutar los siguientes comandos: (Importante) ``` php artisan vendor:publish --tag=rocket-config php artisan migrate php artisan rocket:seeder ``` Middlewares ----------- [](#middlewares) ### Middleware Accept-Json [](#middleware-accept-json) Este middleware, llamado `ApiResponseMiddleware`, se utiliza para manejar las respuestas de la API en formato JSON. 1. Primero, el middleware establece el encabezado 'Accept' de la solicitud a 'application/json'. Esto indica que la aplicación espera recibir una respuesta en formato JSON. 2. Luego, pasa la solicitud al siguiente middleware en la pila o al controlador de la solicitud. 3. Después de recibir la respuesta, establece el encabezado 'Content-Type' de la respuesta a 'application/json'. Esto indica que la respuesta que se está enviando es en formato JSON. 4. Si la respuesta es una instancia de `JsonResponse`, entonces se vuelve a formatear la respuesta utilizando el método `response()->json()`. Este método devuelve una nueva respuesta JSON con los datos y el código de estado de la respuesta original. 5. Si la respuesta no es una instancia de `JsonResponse`, simplemente se devuelve la respuesta tal como está. Este middleware asegura que todas las respuestas de la API estén en formato JSON y tengan los encabezados correctos, independientemente de cómo se generen las respuestas en los controladores. #### \#jemplo de uso: [](#jemplo-de-uso) ``` /* |-------------------------------------------------------------------------- | API Routes |-------------------------------------------------------------------------- | | Here is where you can register API routes for your application. These | routes are loaded by the RouteServiceProvider and all of them will | be assigned to the "api" middleware group. Make something great! | */ Route::group(['middleware' => 'accept-json'], function () { // Aca van las rutas de la API }); ``` ### Middleware RefreshToken [](#middleware-refreshtoken) Este middleware, llamado `RefreshTokenMiddleware`, se utiliza para manejar la renovación de los tokens de acceso en cada solicitud. 1. Primero, el middleware extrae el token de acceso de la solicitud utilizando el método `bearerToken()`. 2. Si se encuentra un token, se busca en la base de datos utilizando el método `findToken()` de la clase `PersonalAccessToken`. 3. Si se encuentra un token de acceso correspondiente, se extiende su fecha de expiración. La nueva fecha de expiración se calcula sumando la cantidad de minutos especificada en la configuración `rocket.sanctum.expiration` a la hora actual. 4. Finalmente, se guarda el token de acceso actualizado en la base de datos y se pasa la solicitud al siguiente middleware en la pila o al controlador de la solicitud. Este middleware asegura que los tokens de acceso se renueven automáticamente en cada solicitud, siempre que sean válidos. #### \#jemplo de uso: [](#jemplo-de-uso-1) ``` /* |-------------------------------------------------------------------------- | API Routes |-------------------------------------------------------------------------- | | Here is where you can register API routes for your application. These | routes are loaded by the RouteServiceProvider and all of them will | be assigned to the "api" middleware group. Make something great! | */ Route::group(['middleware' => 'accept-json'], function () { Route::group(['middleware' => ['auth:sanctum', 'rocket.refresh.token']], function () { // Aca van las rutas de la API que se desean proteger }); }); ``` ``` ## Opcionales ### Herramientas de Desarrollo Para facilitar el desarrollo y depuración de tu aplicación, puedes optar por instalar las siguientes herramientas: - **barryvdh/laravel-debugbar:** Esta herramienta te proporciona una barra de depuración en la parte inferior de tu aplicación cuando estás en el entorno de desarrollo. Para instalarla, ejecuta el siguiente comando: ``` bash composer require barryvdh/laravel-debugbar --dev composer require --dev barryvdh/laravel-ide-helper ``` Recuerda que estos paquetes son opcionales y están destinados a ser utilizados en entornos de desarrollo, no en producción Publicar Recursos del Paquete Rocket ------------------------------------ [](#publicar-recursos-del-paquete-rocket) Rocket proporciona varios recursos que puedes publicar en tu proyecto principal. Para hacerlo, puedes utilizar los siguientes comandos: ### Publicar Migraciones [](#publicar-migraciones) ``` php artisan vendor:publish --tag=rocket-migrations ``` ### Publicar Seeders [](#publicar-seeders) ``` php artisan vendor:publish --tag=rocket-seeders ``` Después de publicar los seeders del paquete Rocket, debes modificar el seeder principal `DatabaseSeeder` de tu proyecto para que pueda ejecutar los seeders de Rocket. Aquí tienes un ejemplo de cómo debería verse tú `DatabaseSeeder`: ``` use Danydevco\Rocket\seeders\RoleSeeder; use Danydevco\Rocket\seeders\ValueSeeder; use Danydevco\Rocket\seeders\ParameterSeeder; use Danydevco\Rocket\seeders\CountrySeeder; use Danydevco\Rocket\seeders\DepartmentSeeder; use Danydevco\Rocket\seeders\CitySeeder; use Danydevco\Rocket\seeders\UserSeeder; class DatabaseSeeder extends Seeder { /** * Seed the application's database. */ public function run(): void { // START ROCKET SEEDERS $this->call([ RoleSeeder::class, ValueSeeder::class, ParameterSeeder::class, CountrySeeder::class, DepartmentSeeder::class, CitySeeder::class, UserSeeder::class, ]); // END ROCKET SEEDERS // \App\Models\User::factory(10)->create(); // \App\Models\User::factory()->create([ // 'name' => 'Test User', // 'email' => 'test@example.com', // ]); } } ``` ### Publicar Vistas [](#publicar-vistas) ``` php artisan vendor:publish --tag=rocket-views ``` ### Publicar Assets [](#publicar-assets) ``` php artisan vendor:publish --tag=rocket-public ``` ### Publicar Configuración [](#publicar-configuración) ``` php artisan vendor:publish --tag=rocket-config ``` ### Publicar Archivos de Lenguaje [](#publicar-archivos-de-lenguaje) ``` php artisan vendor:publish --tag=rocket-lang ``` Estos comandos copiarán los recursos correspondientes del paquete Rocket a tu proyecto principal, permitiéndote personalizarlos según tus necesidades. Restaurar las tablas al estado inicial -------------------------------------- [](#restaurar-las-tablas-al-estado-inicial) ``` php artisan rocket:truncate ``` Agrega el Trait al modelo User ------------------------------ [](#agrega-el-trait-al-modelo-user) ``` use Illuminate\Foundation\Auth\User as Authenticatable; use Danydevco\Rocket\Traits\UserRocketTrait; class User extends Authenticatable{ use UserRocketTrait; // ... } ``` ### Simulación del Atributo Name en el Modelo User [](#simulación-del-atributo-name-en-el-modelo-user) El paquete Rocket no utiliza la columna `name` en la tabla `users`. En su lugar, utiliza las columnas `first_name` y `last_name`. Sin embargo, puedes simular el atributo `name` en el modelo `User` utilizando el trait `UserRocketTrait` proporcionado por el paquete Rocket. El trait `UserRocketTrait` incluye un accesor para el atributo `name` que devuelve la concatenación de los atributos `first_name` y `last_name`. Esto te permite seguir accediendo al atributo `name` en tus instancias del modelo `User` como si la columna `name` existiera en la base de datos. Aquí tienes un ejemplo de cómo puedes usar este accesor: ``` $user = User::find(1); echo $user->name; // Imprime "Nombre Apellido" ``` Caducidad del token ------------------- [](#caducidad-del-token) De forma predeterminada, los tokens de Sanctum caducan cada 30 Minutos. Sin embargo, si deseas configurar un tiempo de caducidad diferente para los tokens de la API en tu aplicación, puedes hacerlo a través de la configuración definida en el archivo `config/rocket.php`. Esta opción de configuración permite definir la cantidad de minutos después de los cuales un token emitido se considerará caducado: ``` /* |-------------------------------------------------------------------------- | Config Sanctum by Rocket |-------------------------------------------------------------------------- */ 'sanctum' => [ /* |-------------------------------------------------------------------------- | Expiration Minutes |-------------------------------------------------------------------------- */ 'expiration' => 30, ], ``` Las tablas por defecto del paquete son: --------------------------------------- [](#las-tablas-por-defecto-del-paquete-son) - users (Actualización de la tabla users de Laravel) - personal\_access\_tokens - model\_has\_permissions - role\_has\_permissions - permissions - model\_has\_roles - roles - values - parameters - countries - departments - cities Usuario por defecto: -------------------- [](#usuario-por-defecto) - email: - password: password Rutas por defecto de la API: ---------------------------- [](#rutas-por-defecto-de-la-api) A continuación se presenta una lista de rutas API disponibles en la aplicación: MétodoRutaControlador y MétodoPOSTapi/assign/permission/to/roleRoleController@assignPermissionToRolePOSTapi/auth/loginAuthController@loginPOSTapi/auth/logoutAuthController@logoutPOSTapi/auth/password/emailAuthController@emailPasswordPOSTapi/auth/password/resetAuthController@resetPasswordGETapi/citiesCityController@indexPOSTapi/citiesCityController@storePUTapi/cities/{city}CityController@updateDELETEapi/cities/{city}CityController@destroyGETapi/countriesCountryController@indexPOSTapi/countriesCountryController@storePUTapi/countries/{country}CountryController@updateDELETEapi/countries/{country}CountryController@destroyGETapi/departmentsDepartmentController@indexPOSTapi/departmentsDepartmentController@storePUTapi/departments/{department}DepartmentController@updateDELETEapi/departments/{department}DepartmentController@destroyGETapi/permissionsPermissionController@indexPOSTapi/permissionsPermissionController@storeGETapi/rolesRoleController@indexPOSTapi/rolesRoleController@storeGETapi/roles/{role}RoleController@showGETapi/valuesValueController@indexPOSTapi/valuesValueController@storeGETapi/values/{value}ValueController@showPUTapi/values/{value}ValueController@updatePOSTapi/values/{value}/parametersParameterController@storePUTapi/values/{value}/parameters/{parameter}ParameterController@update ### Health Score 29 — LowBetter than 59% of packages Maintenance38 Infrequent updates — may be unmaintained Popularity4 Limited adoption so far Community7 Small or concentrated contributor base Maturity56 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 Every ~7 days Recently: every ~16 days Total 52 Last Release 651d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/5f314d249adb2329d34496d1d0745633828e1f34cc0c286e66a5e46c3b5429cf?d=identicon)[danydevco](/maintainers/danydevco) --- Top Contributors [![danydevco](https://avatars.githubusercontent.com/u/112650310?v=4)](https://github.com/danydevco "danydevco (51 commits)") ### Embed Badge ![Health badge](/badges/danydevco-rocket/health.svg) ``` [![Health](https://phpackages.com/badges/danydevco-rocket/health.svg)](https://phpackages.com/packages/danydevco-rocket) ``` ### Alternatives [ashallendesign/short-url A Laravel package for creating shortened URLs for your web apps. 1.4k1.9M4](/packages/ashallendesign-short-url)[intervention/zodiac Zodiac Sign Calculator 58191.7k](/packages/intervention-zodiac)[erlandmuchasaj/laravel-gzip Gzip your responses. 40129.3k2](/packages/erlandmuchasaj-laravel-gzip) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)