Download the PHP package motomedialab/laravel-self-healing-urls without Composer
On this page you can find all versions of the php package motomedialab/laravel-self-healing-urls. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download motomedialab/laravel-self-healing-urls
More information about motomedialab/laravel-self-healing-urls
Files in motomedialab/laravel-self-healing-urls
Package laravel-self-healing-urls
Short Description Generate self-healing URLs for models
License MIT
Homepage https://github.com/motomedialab/laravel-self-healing-urls
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-self-healing-urls
Self-healing URLs in Laravel
This package was inspired Aaron Francis on YouTube - thanks Aaron! This lightweight package allows you to create URLs that are able to self-heal, regardless of the slug provided.
This is great for SEO purposes, allowing you to change slugs without worrying, and will force a 301 redirect to the correct URL.
This technique is commonly used on well known websites such as Amazon and Medium to allow slugs to change without breaking the actual URL.
An example of this would be visiting https://your-site.com/posts/old-slug-12345 automatically redirecting you to
https://your-site.com/posts/new-slug-12345. It does this based on the persisted unique ID at the end of the slug.
This makes use of Laravel's pre-existing route model binding.
Installation
You can install the package via composer:
Usage
To use this package, simply install it, apply the provided trait to your model and tell the trait where the models slug can be found.
In the below examples I've used a Post model, but this really can apply to any model you like.
Once you've done this, you'll also need to add another column to your migrations. This column will store the unique value that should be used within the URL.
I've added a helper to do this:
Extending
While the above will get you going, the package is highly extensible by overriding the traits default methods. A few examples below:
Override the binding column name stored in the database:
Note: You will need to re-run migrations after changing this key.
Override the way the unique ID is generated:
By default, the unique ID is determined using PHP's uniqid function. Regardless, on model creation,
it'll automatically attempt to set a unique ID, and automatically avoid conflicts by generating up to three times.
If it fails to generate a unique key after three attempts, an exception will be thrown.
Update the way the absolute URL to the model is determined (I recommend doing this)
By default, because I don't know your routing structure, it attempts to recreate an absolute URL based on the matched routes name. If no matched route exists, then redirecting will fail and this method should be overridden.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
License
The MIT License (MIT). Please see License File for more information.
