====== Laravel ====== Si voleu desplegar aplicacions dins d'un contenidor, teniu una explicació a https://help.clouding.io/hc/en-us/articles/13590007627164-How-to-Deploy-Laravel-with-Docker-on-Ubuntu-22-04 ====== Tasques periòdiques ====== Laravel inclou dins del seu framework un gestor de tasques periòdiques molt potent https://laravel.com/docs/11.x/scheduling, ara bé, perquè funcioni s'ha de configurar el [[eines:cron]] del servidor seguint les indicacions de https://laravel.com/docs/11.x/scheduling#running-the-scheduler ====== Enviar emails dinàmics amb PHPmailer & Laravel (amb una plantilla blade)====== Si només volem enviar un mail des de codi php "simple" hi ha l'article [[hestia:correu|sobre correus]] que explica com crear un compte de correu al labs i com utilitzar-lo des de php. Per poder utilitzar **PHPmailer**, el primer cop haurem d'instal·lar la dependència amb **composer** de la següent manera:


composer require phpmailer/phpmailer

Després de fer la instal·lació de la dependència haurem d'anar a l'arxiu **api.php** que està en la següent ruta:


back/elTeuNomDeProjecte/routes/api.php

Dins d'aquest arxiu haurem de crear un endpoind e importa el controlador que hem creat per poder enviar el mail i també afegir la view perquè l'usuari pugui veure el contingut del mail. Per crear un controlador a **Laravel** es fa de la següent manera:


php artisan make:controller ElNomDelTeuController

Arxiu **api.php**.


 'Este es un mensaje dinámico']);
});

Per poder crear una view per l'email haurem d'anar a la següent ruta, farem botó dret "Nova carpeta", dintre de la nova carpeta tornarem a fer botó dret "Nou arxiu" i li posem un nom, per exemple **ElMeuBlade.blade.php**:


back/elTeuNomDeProjecte/resources

Les views es fan amb HTML. Un exemple d'una view: **IMPORTANT!**. Tindre en compte els noms dels objectes i variables si no, sortirà un text per defecte.





    {{ $subject ?? 'Example App' }}
    



    {{ $subject ?? 'Example App' }}
    Bienvenido: {{ $name ?? 'User' }} {{$lastname ?? 'User' }}
    Pulsa en el siguiente enlace para acceder al cuestionario:
    
        
            Acceder al cuestionario
        
    

    
        © {{ date('Y') }} Example App. Todos los derechos reservados.

Els controladors es troben en la següent ruta:


back/elTeuNomDeProjecte/app/Http/Controllers/ElNomDelTeuController

Arxiu ElNomDelTeuController.php.



validate([
            'subject' => 'required|string',
            'message' => 'required|string',
            'to' => 'required|array',
            'to.*' => 'required|email', // Cada element hi ha que se valid 
        ]);

        // Configurar PHPMailer
        $mail = new PHPMailer(true);

        try {
            // Configuració del servidor SMTP
            $mail->isSMTP();
            $mail->CharSet = 'UTF-8';
            $mail->Host = env("MAIL_HOST");
            $mail->SMTPAuth = true;
            $mail->Username = env("MAIL_USERNAME");
            $mail->Password = env("MAIL_PASSWORD");
            $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
            $mail->Port = 587;

            $mail->SMTPOptions = [
                'ssl' => [
                    'verify_peer' => false,
                    'verify_peer_name' => false,
                    'allow_self_signed' => true
                ]
            ];

            // Remitent
            $mail->setFrom('correu@example.com', 'Example App');

            // Afegir el destinatari principal (es pot deixar buit si no hi ha principal)
            $mail->addAddress('correu@example.com'); // Este puede ser tu dirección de control

            // Afegir cada destinatari com BCC (còpia oculta)
            foreach ($validatedData['to'] as $recipient) {
                $mail->addBCC($recipient);
            }
            
            // En cas de tindre una vista (blade) la renderitzarem perquè l'usuari el vegi la informació
            // en el correu

            $htmlContent = View::make('email.notification', [
                'subject' => $validatedData['subject'],
                'message' => $validatedData['message'],
            ])->render();

            // Contingut del correu
            $mail->isHTML(true);
            $mail->Subject = $validatedData['subject'];
            $mail->Body = $htmlContent;

            // Enviar el correu
            $mail->send();

            return response()->json([
                'message' => 'Email sent successfully'
            ]);

        } catch (Exception $e) {
            return response()->json([
                'error' => "Error sending email: {$mail->ErrorInfo}"
            ], 500);
        }
    }
}