- What does stoakes/routing-converter do?
- stoakes/routing-converter converts route definitions between supported routing formats, including routing.yml-style definitions and annotations, to simplify migrations and integrations. The package exposes a straightforward API so you can transform existing routes without rewriting them manually. It is distributed as a Composer package.
- How do I install stoakes/routing-converter in a Laravel project?
- Install it with Composer using composer require stoakes/routing-converter. Then use the package API in your migration or integration code to load and convert the route definitions you need. Check the repository README for any service provider or configuration steps specific to your Laravel version.
- Which routing formats does stoakes/routing-converter support?
- The package is described as a routing.yml to annotations converter for Symfony and also as a converter between supported routing formats for Laravel route definitions. In practice, use it to transform existing route definitions into the target format your application expects. Verify the exact supported source and target formats in the repository documentation before relying on it in production.
- Does stoakes/routing-converter work with Laravel 10 and 11?
- The provided context does not list explicit Laravel version constraints, so compatibility should be confirmed against the package composer.json and README. Test installation in a throwaway Laravel 10 or 11 project before adopting it. If your version is not supported, pin an older release or look for an alternative.
- Can I use stoakes/routing-converter to migrate Symfony routing.yml files to annotations?
- Yes, the package overview describes it as a routing.yml to annotations converter for Symfony. It is intended to help move existing YAML route definitions into annotation-based routing without manual rewriting. Review the generated annotations carefully, especially for route names, requirements, defaults, and controller references.
- How do I convert routes in a Laravel application with stoakes/routing-converter?
- Use the package API to load your existing route definitions and output them in the target routing format. The exact method names and options depend on the package version, so follow the README examples. Keep the original route files under version control so you can compare and roll back the generated output.
- Is stoakes/routing-converter suitable for production use?
- It can be used in production migration workflows, but route conversion is usually a build-time or one-off migration task rather than a runtime dependency. Run the converter in a controlled environment, review the generated routes, and test your application route registration and URL generation afterward. Avoid converting routes directly on live servers without a backup and rollback plan.
- How should I test converted routes after using stoakes/routing-converter?
- Compare the original and converted route definitions for names, paths, methods, middleware, requirements, defaults, and controller actions. Then run your Laravel route:list command and feature tests that exercise the affected endpoints. Add regression tests for redirects, route model binding, and URL generation where relevant.
- What are alternatives to stoakes/routing-converter?
- Alternatives depend on whether you are converting Symfony YAML routing, Laravel route files, or another format. For Symfony, consider built-in routing loaders and manual annotation migration; for Laravel, you can often refactor route files directly or use custom scripts. Evaluate alternatives based on format coverage, maintenance activity, and how well they fit your migration plan.
- Is stoakes/routing-converter actively maintained?
- Maintenance activity should be checked on the GitHub repository, including recent commits, releases, and open issues. Because the provided context does not include a release history, verify compatibility with your Laravel and PHP versions before committing. If the package is not actively maintained, fork it or choose a supported alternative for long-term use.