Setting Up a Development Environment Using Laravel Sail (Docker)

Guilherme Lauxen — Fri, 26 Jul 2024 02:18:25 +0000

Laravel Sail is a lightweight command-line interface for interacting with Laravel’s Docker development environment. It provides a complete development environment that includes PHP, MySQL, Redis and more, without the need for manual installation of these services on your local machine. Laravel Sail is perfect for those who want to quickly start a new Laravel project with a standardized development environment.

In this post, I’ll show you how to set up the environment with Laravel Sail without having to install the environment locally.

We will only need Docker. 🐳

Installing the Environment with Laravel Sail

Step 1: Prerequisites

Before you begin, make sure you have Docker installed on your machine. You can download and install Docker from the official website: Docker.

Step 2: Installing Laravel Sail

Installing Laravel Sail is simple and can be done with a single command. Below are the instructions to install Laravel Sail on MacOS, Windows, and Linux.
Open your terminal and run the following command:



curl -s "https://laravel.build/example-app" | bash

This command will download and configure a new Laravel application called example-app in a directory with the same name. Feel free to replace example-app with your project’s name.

Choosing Your Sail Services

When creating a new Laravel application via Sail, you may use the with query string variable to choose which services should be configured in your new application’s docker-compose.yml file. For available services, see the Laravel Sail documentation.



curl -s "https://laravel.build/example-app?with=mysql,redis" | bash

If you do not specify which services you would like configured, a default stack will be set up. In Laravel 11, this default stack includes mysql, redis, meilisearch, mailpit, and selenium.

Step 3: Starting Laravel Sail

Once the installation is complete, navigate to your project’s directory and start the Laravel Sail development environment:



cd example-app
./vendor/bin/sail up

This command will start the Docker containers defined by Laravel Sail, including the web server, database, and other services.

Step 4: Running Migrations

After starting the environment with sail up, you will need to run the migrations to set up the database:



./vendor/bin/sail artisan migrate

This command will apply all pending migrations, setting up the database for use with your Laravel application.

Creating an Alias for the Sail Command

To make using the ./vendor/bin/sail command easier, you can create an alias in your terminal. This will allow you to run sail commands without typing the full path.

Creating an Alias on MacOS and Linux

Open your shell configuration file (usually ~/.bashrc, ~/.zshrc, or ~/.bash_profile) and add the following line:



alias sail='[ -f sail ] && bash sail || bash vendor/bin/sail'

Then, reload the shell configuration file:



source ~/.bashrc
# or
source ~/.zshrc
# or
source ~/.bash_profile

Creating an Alias on Windows (PowerShell)

To create an alias in PowerShell, add the following line to your PowerShell profile ($PROFILE):



New-Alias sail vendor/bin/sail

Then, reload the PowerShell profile:



. $PROFILE

Using the Alias

Now you can use the sail command directly in the terminal. For example, to start the development environment, simply run:



sail up

To run migrations, use:



sail artisan migrate

Tip: Installing PHP Modules and Extensions

If you need to install additional PHP modules or extensions, such as GMP, you can access the Dockerfile used by Laravel Sail and make the necessary modifications.

Navigate to the ./vendor/laravel/sail/runtimes/ directory.
Choose the version of PHP you are using (e.g., 8.3).
Open the corresponding Dockerfile and add the instructions to install the desired extension. For example, to install php8.3-gmp, you can add:

After modifying the Dockerfile, rebuild the Docker containers to apply the changes:



sail build --no-cache

Conclusion

Laravel Sail simplifies the setup of the development environment, providing a standardized and easy-to-use environment. With the steps above, you can install Laravel Sail on MacOS, Windows, and Linux, create an alias to make using Sail commands easier, and install additional modules as needed.

Try it out and see how Laravel Sail can speed up your development workflow!

Hope it helps!! 🤓

How to Implement Sentiment Analysis with PHP and AWS Comprehend

Guilherme Lauxen — Wed, 10 Jul 2024 18:58:45 +0000

Hi everyone, 👋

Imagine you implement a chatbot that analyzes in real-time how a conversation is going. Is the client happy 😄 or sad 😔 about the situation? Cool, isn’t it? Or imagine analyzing an email from a client and quantifying it in your indicators to see which one needs more attention.

In this post, I’d like to share how to implement a powerful tool to analyze texts, called AWS Comprehend.

Important to know:
Amazon Comprehend Free Tier allows up to 50,000 character units per month for the first 12 months. After that, you need to check the prices on the AWS platform.

Hands-on 💪

1. Create user in AWS.

Go to AWS Management Console and create your login.
Search for IAM.
Click on Users -> Create User
Specify a name (whatever you want) for the user and click on Next
Set permissions for the user. For our tests, we’re going to use just one policy (ComprehendFullAccess), but for your project, you can define more policies as needed.
Now it’s time to review and create the user.
After creating the user, it’s time to create an Access Key. Click on the user that has been created, and in Summary, click on Create access key.
Select Local code for the use case (for our tutorial it’s fine).
Set a description tag. I like to use the name of the case example: local-code-access-key, but you can use any name.
After creating, you can show the access_key and secret_key on the screen or download a CSV with credentials. Save this because we’re going to use it to connect with AWS.

2. Install the AWS SDK for PHP.

Use Composer to install the AWS SDK for PHP library.

composer require aws/aws-sdk-php

3. Implementing code

This is an example of how you can implement sentiment analysis. Create a file named analyze_sentiment.php and copy this code.



<?php

require 'vendor/autoload.php';

// Using the AWS Comprehend library

use Aws\Comprehend\ComprehendClient;

// Configuring the client

$client = new ComprehendClient([

    'version' => 'latest',

    'region'  => 'us-east-1', // Use your preferred region

    'credentials' => [

        'key'    => 'PASTE_YOUR_ACCESS_KEY',

        'secret' => 'PASTE_YOUR_SECRET_ACCESS_KEY',

    ]

]);

// Text to analyze

$textToAnalyze = 'Thanks for resolving my problem, but it was too late.';

// Using the method detectSentiment to analyze

$result = $client->detectSentiment([

    'Text' => $textToAnalyze,

    'LanguageCode' => 'en'

]);

// Result of analysis

echo 'Text: ' . $textToAnalyze;

echo '<br>Sentiment: ' . $result['Sentiment'];

echo '<pre>';

print_r($result['SentimentScore']);

echo '</pre>';

?>

The result looks like this.

This is an example of how you can implement this in your applications. You can use most methods in this library to analyze images, files, and more. Just check the AWS Comprehend Documentation

Hope this is useful for you. 👊
See you soon.

DEV Community: Guilherme Lauxen