DEV Community: Ariel Mejia

Fix commond Laravel Horizon issues

Ariel Mejia — Tue, 17 Jun 2025 21:00:56 +0000

Ok you have some jobs to process in the background using Redis, the first problem that you can get is:

php_network_getaddresses: getaddrinfo for redis failed: nodename nor servname provided, or not known

We are going to tackle this in different steps, first check if you have installed Redis locally, in your terminal run:

Step 1: Install Redis

brew install redis

Check Redis installation

php -m | grep redis

You should be able to see that the redis module is installed

Step 2: Set Redis variables

In the .env file set or replace this values:

# Driver configuration
CACHE_DRIVER=redis
QUEUE_CONNECTION=redis
SESSION_DRIVER=redis

# Redis setup
REDIS_HOST=localhost
REDIS_PASSWORD=null
REDIS_PORT=6379

If you are using Herd everything would work, if you are using Herd Pro there is a services section, ONLY if you are using that specific feature this variable should change REDIS_PORT=6138

Step 3: Install Laravel Horizon

In the terminal execute:

composer require laravel/horizon

And this other command to publish the files:

php artisan horizon:install

Step 4: Check the connection

In the terminal execute:

php artisan horizon

You should be able to see the horizon response:

Horizon started successfully.

Step 5: Check Horizon Dashboard

Go to the browser and add to your project url your-project.test/horizon

Then you should be able to see the Horizon dashboard with status: active

Now, you are able to run jobs and monitor them in horizon.

Bonus

Step 6: Set Queues for different Jobs:

You can go to config/horizon.php and set specific queues and even add more supervisors, by default it checks only "defaul" queue, but as it is an array you can add multiple of them:

    'defaults' => [
        'supervisor-1' => [
            'connection' => 'redis',
            'queue' => ['default', 'sendEmailInvites'],

Now you only need to set a specific queue for your emails with something like this:

Mail::to('user@example.com')
    ->queue((new InvitationEmail($data))->onQueue('sendEmailInvites'));

You can even go further and set Queue Configuration (not necessary)

Make sure your config/queue.php has the queue configured:

'connections' => [
    'redis' => [
        'driver' => 'redis',
        // ... other config
        'queue' => env('REDIS_QUEUE', 'default'),
    ],
],

// You can also define named queues
'sendEmailInvites' => [
    'driver' => 'redis',
    'queue' => 'sendEmailInvites',
],

Create and Register a new SSH on Github

Ariel Mejia — Wed, 28 Aug 2024 22:46:24 +0000

It only requires three steps

1 Create a new SSH key

ssh-keygen -o -t rsa -C "email@example.com"

2 Copy the content

Just check the output of the first command, it would add a path of the ssh key .pub file, now just copy the content:

pbcopy < /Users/<your-user-name>/.ssh/id_rsa.pub

3 Register a new ssh key in GitHub

You can add the content of the key in the form of this URL

https://github.com/settings/ssh/new

it is done... happy coding!

Set an awesome terminal in MacOS

Ariel Mejia — Wed, 28 Aug 2024 21:44:37 +0000

Here a few tips that would bring your terminal experience to a whole new level.

Install Homebrew

You can install homebrew Here

Install Iterm

It allows to work on a pretty custom terminal

You can install Iterm 2 Here

Personally I like to change iterm colors, it is placed in: preference > profiles > colors tab > colors preset, then just choose the preset you like.

Optionally you can add a custom theme for Iterm

You can find iterm themes Here

Take in mind to add a theme you need to create an .itermcolors file

For example I like Dracula Theme

So in order to add it I need to grab the content and create file like:

cd $HOME
vi .Dracula.itermcolors

Then insert the content of the selected theme in my case for dracula

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Ansi 0 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.0</real>
        <key>Green Component</key>
        <real>0.0</real>
        <key>Red Component</key>
        <real>0.0</real>
    </dict>
    <key>Ansi 1 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.3333333432674408</real>
        <key>Green Component</key>
        <real>0.3333333432674408</real>
        <key>Red Component</key>
        <real>1</real>
    </dict>
    <key>Ansi 10 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.4823529411764706</real>
        <key>Green Component</key>
        <real>0.98039215686274506</real>
        <key>Red Component</key>
        <real>0.31372549019607843</real>
    </dict>
    <key>Ansi 11 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.5490196078431373</real>
        <key>Green Component</key>
        <real>0.98039215686274506</real>
        <key>Red Component</key>
        <real>0.94509803921568625</real>
    </dict>
    <key>Ansi 12 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.97647058823529409</real>
        <key>Green Component</key>
        <real>0.57647058823529407</real>
        <key>Red Component</key>
        <real>0.74117647058823533</real>
    </dict>
    <key>Ansi 13 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.77647058823529413</real>
        <key>Green Component</key>
        <real>0.47450980392156861</real>
        <key>Red Component</key>
        <real>1</real>
    </dict>
    <key>Ansi 14 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.99215686274509807</real>
        <key>Green Component</key>
        <real>0.9137254901960784</real>
        <key>Red Component</key>
        <real>0.54509803921568623</real>
    </dict>
    <key>Ansi 15 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>1</real>
        <key>Green Component</key>
        <real>1</real>
        <key>Red Component</key>
        <real>1</real>
    </dict>
    <key>Ansi 2 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.4823529411764706</real>
        <key>Green Component</key>
        <real>0.98039215686274506</real>
        <key>Red Component</key>
        <real>0.31372549019607843</real>
    </dict>
    <key>Ansi 3 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.5490196078431373</real>
        <key>Green Component</key>
        <real>0.98039215686274506</real>
        <key>Red Component</key>
        <real>0.94509803921568625</real>
    </dict>
    <key>Ansi 4 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.97647058823529409</real>
        <key>Green Component</key>
        <real>0.57647058823529407</real>
        <key>Red Component</key>
        <real>0.74117647058823533</real>
    </dict>
    <key>Ansi 5 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.77647058823529413</real>
        <key>Green Component</key>
        <real>0.47450980392156861</real>
        <key>Red Component</key>
        <real>1</real>
    </dict>
    <key>Ansi 6 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.99215686274509807</real>
        <key>Green Component</key>
        <real>0.9137254901960784</real>
        <key>Red Component</key>
        <real>0.54509803921568623</real>
    </dict>
    <key>Ansi 7 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.73333334922790527</real>
        <key>Green Component</key>
        <real>0.73333334922790527</real>
        <key>Red Component</key>
        <real>0.73333334922790527</real>
    </dict>
    <key>Ansi 8 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.33333333333333331</real>
        <key>Green Component</key>
        <real>0.33333333333333331</real>
        <key>Red Component</key>
        <real>0.33333333333333331</real>
    </dict>
    <key>Ansi 9 Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.33333333333333331</real>
        <key>Green Component</key>
        <real>0.33333333333333331</real>
        <key>Red Component</key>
        <real>1</real>
    </dict>
    <key>Background Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.15977837145328522</real>
        <key>Green Component</key>
        <real>0.12215272337198257</real>
        <key>Red Component</key>
        <real>0.11765811592340469</real>
    </dict>
    <key>Bold Color</key>
    <dict>
        <key>Blue Component</key>
        <real>1</real>
        <key>Green Component</key>
        <real>1</real>
        <key>Red Component</key>
        <real>1</real>
    </dict>
    <key>Cursor Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.73333334922790527</real>
        <key>Green Component</key>
        <real>0.73333334922790527</real>
        <key>Red Component</key>
        <real>0.73333334922790527</real>
    </dict>
    <key>Cursor Text Color</key>
    <dict>
        <key>Blue Component</key>
        <real>1</real>
        <key>Green Component</key>
        <real>1</real>
        <key>Red Component</key>
        <real>1</real>
    </dict>
    <key>Foreground Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.94901961088180542</real>
        <key>Green Component</key>
        <real>0.97254902124404907</real>
        <key>Red Component</key>
        <real>0.97254902124404907</real>
    </dict>
    <key>Selected Text Color</key>
    <dict>
        <key>Blue Component</key>
        <real>1</real>
        <key>Green Component</key>
        <real>1</real>
        <key>Red Component</key>
        <real>1</real>
    </dict>
    <key>Selection Color</key>
    <dict>
        <key>Blue Component</key>
        <real>0.35294118523597717</real>
        <key>Green Component</key>
        <real>0.27843138575553894</real>
        <key>Red Component</key>
        <real>0.26666668057441711</real>
    </dict>
</dict>
</plist>

And save

Then Go to Settings > Profiles > Colors > Colors Presets > Import > Users Home Directory

Then press the three keys at the same time command+shift+. to show hidden files and select the color theme created.

Install Oh My Zsh

It allows to add more abilities to your terminal

You can install it here

Install Power Level 10 theme

It adds a lot of customizations options handled with an installation wizard:

Clone manually

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ~/powerlevel10k
echo 'source ~/powerlevel10k/powerlevel10k.zsh-theme' >>~/.zshrc

Install using oh my zshell

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

Then edit the oh my zsh rc file:

Using vi

vi ~/.zshrc

Using nano

nano ~/.zshrc

Search for the ZSH_THEME key and update the value:

ZSH_THEME="powerlevel10k/powerlevel10k"

Restart ZSH

exec zsh

It would run the installation wizard automatically.

To run again in the future the wizard execute p10k configure

Install autosuggestions

Now you are able to install autosuggestions with "Oh My ZSH" the installation guide here

Install Bat

cat is a command to show a file content, bat does pretty much the same, but adding highlight syntax in the terminal output:

Install it using Hombrew

brew install bat

Install it using MacPorts

port install bat

Set Syntax Highlight Theme

Generate a config file

bat --generate-config-file

The output should look like this:

Success! Config file written to /Users/<username>/.config/bat/config

Grab the output and edit the file:

vi /Users/<username>/.config/bat/config

In this case, I update the theme to "Dracula", but there are some pretty popular themes like "Nord" or "Monokai"

--theme="Dracula"

Set Vim syntax

open vim .vimrc

And set this values (you can go as far as you need, this is just a simple example)

set showmode
set autoindent
set tabstop=4
set expandtab
syntax on

Set same terminal font for VSCode

Open VSCode and press CMD + ,

Then would open the palette and type settings.json then add the font family and size that you want, in this case I would use the same Font Family from iterm using powerlevel10 theme:

"terminal.integrated.fontFamily": "Meslo LG M for Powerline"
"terminal.integrated.fontSize": 14

There are a lot of changes so it requires restarting your computer

There is room to improve your terminal even more, in my case this configuration is fine, but there are other pretty common tools like:

Thanks for reading!

Remove all git local branches except "main"

Ariel Mejia — Sat, 24 Aug 2024 08:17:03 +0000

Working locally would tempt to acummulate a lot of git branches locally, most of the time we want to keep only the "main" branch, to execute this just run:

git branch | grep -v "main" | xargs git branch -D

Explanation

The first section git branch list all the branches locally.
grep -v "main" filter out from the output branches list the main branch
xargs git branch -D runs git branch -D to all the branch items inside the branch list

Happy Coding!

Test Your DOM in Laravel with PHPUnit

Ariel Mejia — Sun, 21 Jul 2024 18:49:10 +0000

PHPUnit comes out of the box with features like AssertSee and AssertSeeText in both cases we can assert against a specific text, to assert HTML tags we are going to rely on these features with some custom work to polish these a little bit more.

Case of use

I need to test that some forms generate a CSRF token.

Basic Solution

Laravel CSRF token directive generates an input like this:

<input type="hidden" name="_token" value="random_generated_token" ...>

As the generated token changes between requests we are not going to test the generated token value, instead we are going to assert that the input exists with some of the attributes required, PHPUnit assertSee has second param to escape a value so we can do something like this:

$this
    ->get("contact-us")
    ->assertSee([
        '<input name="some_database_column"'
    ], false);

Improving iteration

It would solve our solution, but probably there is a better way to use this for more cases, so writing using a "wishful thinking" approach my desired code would be something like this:

$this->get("contact-us")
    ->assertHtml('input', [
        "type" => "hidden",
        "name" => "_token",
])

This would be useful as it adds an assertion that would work in multiple cases by only passing the tag name and an array of attributes

We can add something like this in Laravel by adding a custom macro to the TestResponse class in the AppServiceProvider or any other custom Provider:

TestResponse::macro('assertHtml', function ($tag, $attributes) {
    $attributes = collect($attributes)
        ->map(function ($attributeValue, $attributeKey) {
            return "$attributeKey=\"$attributeValue\" ";
        })
        ->values()
        ->implode("", "");

        $htmlElement = "<$tag $attributes";
        $this->assertSee([$htmlElement], false);
});

Now we can test our DOM by testing the presence of a tag and an attribute.

Aiming Laravelish Way

We can go a little bit forward in this case, I would need to assert that a form as CSRF tokens in multiple forms in the app, so we can rely on our macro to create more assertions, in this case as the expected HTML tag and attributes would not change I can add something like this:

TestResponse::macro('assertCSRFTokenExists', function () {
    $this->assertHtml('input', [
        "type" => "hidden",
        "name" => "_token",
    ]);
});

This assertion is short, reusable, easy to read and use:

$this->get("contact-us")->assertCSRFTokenExists();

For more powerful assertions you should consider an excellent package like:

sinnbeck/laravel-dom-assertions

Hopefully, this helps to add basic DOM assertions in your tests

Customize Filament Table Query

Ariel Mejia — Sun, 30 Jun 2024 18:32:44 +0000

I am going to share how you can customize the query applying filters, this tip has a meilisearch example borrowed as I found the tip in a laracast chat, the content was enriched by me.

To customize the table search to use some Laravel Scout Driver to get a fuzzyness search or a more powerful search in terms of speed:

The Inline Way

// filter criteria
$filter = '(status = Active) AND (type = big)';

// $this->query is a prop provided by extending from filament resource class
$company_ids = \App\Models\Company::search($this->query, function (\Meilisearch\Endpoints\Indexes $meilisearch, $query, $options) use($filter) {
    // This is a custom configuration for Meilisearch only
    $options['facets'] = ['type','status'];
    $options['filter'] = $filter;
    $options['hitsPerPage'] = 100;
    return $meilisearch->search($query, $options);
})->get()->pluck('id');

return $table
    ->query(\App\Models\Company::whereIn('id', $company_ids))
    ->columns([
        TextColumn::make('name')->sortable(),
        TextColumn::make('status')->sortable(),
        TextColumn::make('type')->sortable()
    ])

The Override Way

We can also override the getEloquentQuery method, like this example removing a global scope for soft deletes:

public static function getEloquentQuery(): Builder
{
    return parent::getEloquentQuery()
        ->withoutGlobalScopes([SoftDeleted::class])
        ->with(['products']);
}

Change Default Colors in FilamentPHP

Ariel Mejia — Sun, 30 Jun 2024 18:18:10 +0000

Set Colors for a single Resources

Using filament we are able to define the colors for all the resources in the AppPanelProvider.php class, this class is typically the one that is created by default in a filament project installation command, we can define a lot of features in this case we are going to set the colors for the whole resources:

public function panel(Panel $panel): Panel
{
    return $panel
        ->default()
        ->id('app')
        ->path('/')
        ->login()
        ->colors([
            'primary' => Color::Slate,
            'gray' => Color::Gray
        ]);
}

Now all the genereated resources are going to use this colors, take in mind that the value of the colors is handle by a Color class provided by Filament in the namespace namespace Filament\Support\Colors and it provides an identifier for all the colors in the TailwindCSS color pallete.

Set colors in a custom action

You can define custom actions using vainilla livewire components, in this cases you would need to explicitly define the color by chaining the colors method:

->color(Color::Slate)

Set Colors Globally

From a service provider's boot() method you can define the colors for your app globally:

public function boot(): void
{
    FilamentColor::register([
        'danger' => Color::Red,
        'gray' => Color::Zinc,
        'info' => Color::Blue,
        'primary' => Color::Indigo,
        'success' => Color::Green,
        'warning' => Color::Amber,
    ]);
}

In this example this script replace the Amber color as the primary color for the Indigo all of the Tailwind Colors Pallette is available in the Colors class provided by Filament.

You can add more color options and even customize them from hex color codes to customize it even more you can follow the docs for this section here

Thanks for reading!

Debug Filament Search Query

Ariel Mejia — Thu, 20 Jun 2024 06:18:20 +0000

Filament Resources allow to create quickly tables by mapping objects, it allows to add easily pretty common features like:

sortable
searchable
and more features

in this case to debug the search query we can check the List class that is created by default when a user creates a filament resource, eg:

User Resource

class UserResource extends Resource
{
    protected static ?string $model = User::class;

    public static function getPages(): array
    {
        return [
            'index' => ListUsers::route('/'),
            // ... more pages
        ];
    }
}

ListUsers

Here we can override a getFilteredTableQuery method to check the raw sql and debug the query

protected function getFilteredTableQuery(): Builder
{
    dd(parent::getFilteredTableQuery()->toRawSql());
}

Hope it is useful & Happy Coding!

Open Successfully iOS Simulator with React Native & Expo

Ariel Mejia — Wed, 19 Jun 2024 01:01:11 +0000

There are some downsides in the process to run IOS Simulator using Expo, here is a little guide to fix these issues:

Install X Code

Here a link to install
Xcode

Install Xcode Command Line Tools

This is a tricky section as at the first installation it looks like there is a Command Line Tools already selected, but it is not, you can find it in Xcode > Preferences > Locations so we need to click the option that appears to set the Command Line Tools path

Install Watchman



brew update
brew install watchman

Run Expo



npx expo start

and press i to select ios simulator

Fixes

The easiest solution is to restart the computer.
The second solution is to delete node_modules folder and package-lock.json, then run npm install, then run npx expo start.

In Summary

The sections where most issues to run iOS Simulator are:

User has not select Command Line Tools
Sometimes previous attempts to make it run can produce issues, to avoid this just delete node_modules and re-run npm install.

Laravel get route name from given URL

Ariel Mejia — Fri, 24 May 2024 14:38:48 +0000

A common use case for a tabs component is to check if a routes as strings is the current route or if it exists in your app.

Laravel Route facade allows to expose the route object easily to check this:

Using the route name

$route = route('users.index');

Route::getRoutes()->match($route);

Using a string

$url = 'https://your-app.com/users';

Request::create($url)

Hope that the tip is useful!

Customize Reset Password Mail in Laravel

Ariel Mejia — Wed, 13 Mar 2024 23:08:49 +0000

Overview

Laravel provides by default a forgot password feature for User model, you can find it in authorizable alias that extends to User model:

class User extends Model implements
    AuthenticatableContract,
    AuthorizableContract,
    CanResetPasswordContract
{
    use Authenticatable, Authorizable, CanResetPassword, MustVerifyEmail;
}

User model has a method that send the notification to reset password:

sendPasswordResetNotification($token)

We can override it to handle or custom messages.

Customizing Reset Password notification

First, we are going to create or own notification that would extend from the default ResetPassword notification from Laravel:

In terminal create a new notification:

php artisan make:notification ResetPassword

Then we are going to override sendPasswordResetNotification method in User model:

use App\Notifications\ResetPassword;

class User
{
    // ...

    public function sendPasswordResetNotification($token)
    {
        $this->notify(new ResetPassword($token));
    }
}

Just make sure that you import our custom notification.

Customize notification

In this example for the sake of simplicity I am going to extend from the default resetPassword from Laravel

Eg: replace a subject message:

    protected function buildMailMessage($url)
    {
        return (new MailMessage)->subject('Here a custom subject');
    }

Fix Memory Exhausted Issue in Laravel Tests

Ariel Mejia — Wed, 28 Feb 2024 22:09:45 +0000

Quick and easy tip, sometimes a test could take too much time/memory, you can set your local environment memory_limit, but take in mind that you should repeat this process on every environment (local, staging, production) and all development team environments should add this configuration, not best solution right?

Fortunately. PHPUnit provides a simple solution for this cases you can set a memory_limit value that would instruct the memory limit only when the app runs tests.

In your phpunit.xml file add this configuration:

<php>
 ...
 <ini name="memory_limit" value="512M"/>
</php>