https://www.pavelzanek.com/cs/blog Moje články, poznatky a novinky z praxe cs Wed, 20 May 2026 05:59:23 +0200 https://www.pavelzanek.com/cs/blog/artisan-console-command-make https://www.pavelzanek.com/cs/blog/artisan-console-command-make Fri, 01 Sep 2023 00:00:00 +0200 'Post', '--migration' => true, '--controller' => true]); Artisan::call('make:seeder', ['name' => 'PostsTableSeeder']); Optimalizace Šablon pro Týmovou Práci Pokud pracujete v týmu, je důležité zajistit, že všechny generované soubory budou mít konzistentní a očekávanou strukturu. Customizované šablony můžete uložit do verzovacího systému (např. Git), aby je mohl celý tým používat. Tipy pro týmovou práci Sdílejte Customizované Šablony: Uložte je v repozitáři, aby měl přístup celý tým. Dokumentujte Změny: Když upravíte šablonu, dokumentujte, co a proč jste změnili, aby to bylo jasné pro ostatní členy týmu. Běžné chyby a jak je řešit Chyba: třída již existuje Chyba se objeví, když se pokusíte vytvořit třídu, která již v aplikaci existuje. Řešení Zkontrolujte adresář: Ujistěte se, že třída skutečně již existuje, prohlédnutím příslušného adresáře. Přejmenujte třídu: Pokud potřebujete vytvořit novou třídu s jiným účelem, zvažte přejmenování třídy, aby nedošlo ke konfliktu jmen. Chyba: neplatné jméno třídy Chyba nastane, pokud zadáte neplatné jméno třídy při používání příkazu `make`. Řešení Zkontrolujte syntaxi: Ujistěte se, že jméno třídy je ve správném formátu. Mělo by začínat velkým písmenem a nesmí obsahovat neplatné znaky. Použijte správný příkaz: Ujistěte se, že používáte správný Artisan příkaz pro generování požadovaného typu souboru. Chyba: šablona nebyla nalezena Chyba se objeví, pokud Laravel nemůže najít potřebnou šablonu (stub) pro generování souboru. Řešení Zkontrolujte adresář se šablonami: Ujistěte se, že všechny šablony jsou na správném místě v adresáři `stubs/` ve vašem kořenovém adresáři aplikace. Publikujte šablony znovu: Pokud chybí některé šablony, zkuste je znovu publikovat pomocí příkazu: `php artisan stub:publish` Chyba: syntax error v generovaném souboru Chyba nastane, pokud je v generovaném souboru chyba v syntaxi PHP. Řešení Zkontrolujte šablony: Chyba může být v šabloně, kterou Laravel použil k vytvoření souboru. Zkontrolujte šablonu a opravte chybu. Zkontrolujte generovaný Soubor: Otevřete generovaný soubor a najděte a opravte chybu v syntaxi PHP. Závěr Příkaz `make` v Artisan Console Laravelu je silný nástroj, který výrazně zvyšuje produktivitu vývojáře tím, že automatizuje proces vytváření nových tříd a souborů. Umožňuje generovat různé typy souborů, od kontrolerů a modelů až po testy a migrace. Šablony (stubs) jsou klíčovou součástí tohoto procesu a mohou být customizovány podle potřeb vývojáře. Běžné chyby při používání příkazu `make` jsou snadno řešitelné a většinou souvisí s názvy tříd, umístěním šablon nebo syntaxí PHP. Důležitost efektivního využití příkazu 'make' Efektivní využití příkazu `make` může výrazně zlepšit workflow vývojáře, umožňuje rychlejší vývoj a snižuje riziko chyb tím, že poskytuje konzistentní a spolehlivé způsoby generování kódu. Je to nástroj, který by měl být součástí každého Laravel vývojářova arzenálu. Doporučení pro další kroky Prozkoumejte další příkazy Artisan: Laravel Artisan nabízí mnoho dalších příkazů, které mohou usnadnit vývoj. Zkuste např. `php artisan list` pro zobrazení všech dostupných příkazů. Studujte dokumentaci Laravelu: Dokumentace Laravelu je bohatým zdrojem informací. Věnujte čas jejímu procházení a učte se o dalších funkcích, které framework nabízí. ]]> https://www.pavelzanek.com/cs/blog/generative-ai-rapid-rise-impact-tech-world https://www.pavelzanek.com/cs/blog/generative-ai-rapid-rise-impact-tech-world Tue, 15 Aug 2023 00:00:00 +0200 https://www.pavelzanek.com/cs/blog/amazon-ai-generating-product-descriptions https://www.pavelzanek.com/cs/blog/amazon-ai-generating-product-descriptions Sun, 13 Aug 2023 00:00:00 +0200 https://www.pavelzanek.com/cs/blog/rss-feed-laravel https://www.pavelzanek.com/cs/blog/rss-feed-laravel Thu, 10 Aug 2023 00:00:00 +0200 https://www.pavelzanek.com/cs/blog/google-howto-faq-rich-results https://www.pavelzanek.com/cs/blog/google-howto-faq-rich-results Wed, 09 Aug 2023 00:00:00 +0200 https://www.pavelzanek.com/cs/blog/laravel-livewire-crud https://www.pavelzanek.com/cs/blog/laravel-livewire-crud Thu, 29 Jun 2023 00:00:00 +0200 https://www.pavelzanek.com/cs/blog/laravel-crud https://www.pavelzanek.com/cs/blog/laravel-crud Sat, 24 Jun 2023 00:00:00 +0200 https://www.pavelzanek.com/cs/blog/seo-ai-optimization-chatgpt-browse-with-bing https://www.pavelzanek.com/cs/blog/seo-ai-optimization-chatgpt-browse-with-bing Thu, 22 Jun 2023 00:00:00 +0200 https://www.pavelzanek.com/cs/blog/laravel-newsletter https://www.pavelzanek.com/cs/blog/laravel-newsletter Wed, 21 Jun 2023 00:00:00 +0200 $this->faker->email(), 'language' => NewsletterLanguage::ENGLISH, 'is_verified' => false, ]; } } Tato továrna nám nyní umožní vytvářet testovací instance našeho modelu NewsletterUser s náhodnými daty. To se nám bude hodit při dalším vývoji a testování našeho systému pro přihlášení k newsletteru. Migrace databáze Migrace je klíčová součást Laravelu, která nám umožňuje vytvořit strukturu naší databáze přímo z našeho kódu. Vytvořme tedy migraci pomocí artisan příkazu: php artisan make:migration create_newsletter_users_table V našem případě jsme vytvořili migraci pro model NewsletterUser, který obsahuje všechny nezbytné informace pro správu odběratelů newsletteru, jako je email, jazyk a stav ověření. <?php use App\Enums\Newsletter\NewsletterLanguage; use Illuminate\Database\Migrations\Migration; use Illuminate\Database\Schema\Blueprint; use Illuminate\Support\Facades\Schema; return new class extends Migration { /** * Run the migrations. */ public function up(): void { Schema::create('newsletter_users', function (Blueprint $table) { $table->id(); $table->string('email', 128)->unique(); $table->string('language', 6)->default(NewsletterLanguage::ENGLISH->value); $table->boolean('is_verified')->default(false); $table->string('verification_token', 60)->nullable(); $table->timestamps(); $table->softDeletes(); }); } /** * Reverse the migrations. */ public function down(): void { Schema::dropIfExists('newsletter_users'); } }; Díky migraci můžeme snadno vytvářet, modifikovat i mazat tabulky v databázi, což je velmi užitečné při vývoji aplikace a distribuci mezi různými prostředími. Navíc, Laravel automaticky sleduje, jaké migrace již byly aplikovány, takže nemusíme řešit jejich opakované spouštění. Vytvoření šablony pro email Když uživatel zadá svůj email a vybere preferovaný jazyk newsletteru, potřebujeme mu poslat ověřovací email. Ten obsahuje ověřovací odkaz, na který musí uživatel kliknout pro ověření svého emailu. Pro tento účel budeme potřebovat vytvořit emailovou šablonu. Laravel opět nabízí velmi pohodlnou práci s emailovými šablonami. Začneme tím, že vytvoříme novou třídu pro naši emailovou notifikaci pomocí Artisan příkazu: php artisan make:mail NewsletterVerificationMail --markdown=emails.newsletter-verification Tímto příkazem jsme vytvořili novou třídu NewsletterVerificationMail a zároveň jsme Laravelu řekli, že chceme použít markdown formát pro vytvoření naší emailové šablony. Laravel za nás automaticky vytvořil soubor pro tuto šablonu v adresáři resources/views/emails. Nyní můžeme tuto šablonu upravit podle našich potřeb. V našem případě si pro ukázku potřebujeme v emailu zobrazit několik informací: Uvítací zprávu Ověřovací odkaz Tlačítko pro přesměrování na naši webovou stránku Výsledná šablona by mohla vypadat následovně: <x-mail::message> # {{ __('template.newsletter-email-verification-headline') }} {{ __('template.newsletter-email-verification-description') }} <x-mail::button :url="$signedUrl"> {{ __('template.newsletter-email-verification-verify-button') }} </x-mail::button> <x-mail::button :url="$homepageUrl"> {{ __('template.newsletter-email-verification-homepage-button') }} </x-mail::button> {{ __('template.newsletter-email-verification-thanks') }},<br> {{ config('app.name') }} </x-mail::message> V této šabloně jsme použili Laravelovské komponenty mail::message a mail::button, které nám umožňují snadno vytvořit strukturu našeho emailu. Texty jsou načítány z překladových souborů, takže můžeme snadno přepínat mezi různými jazyky podle toho, jaký jazyk si uživatel zvolil. Nakonec je třeba tuto šablonu použít v naší třídě NewsletterVerificationMail: <?php namespace App\Mail\App\Guest\Newsletter; use App\Models\Newsletter\NewsletterUser; use Illuminate\Bus\Queueable; use Illuminate\Contracts\Queue\ShouldQueue; use Illuminate\Mail\Mailable; use Illuminate\Mail\Mailables\Content; use Illuminate\Mail\Mailables\Envelope; use Illuminate\Queue\SerializesModels; use Illuminate\Support\Facades\URL; class NewsletterVerificationMail extends Mailable { use Queueable, SerializesModels; public NewsletterUser $newsletterUser; public function __construct(NewsletterUser $newsletterUser) { $this->newsletterUser = $newsletterUser; } /** * Get the message envelope. */ public function envelope(): Envelope { return new Envelope( subject: __('template.newsletter-email-verification-subject') . ' | PavelZanek.com', ); } /** * Get the message content definition. * * @return \Illuminate\Mail\Mailables\Content */ public function content() { $signedUrl = URL::signedRoute('newsletter.verify-user', [ 'language' => $this->newsletterUser->language, 'token' => $this->newsletterUser->verification_token ]); return new Content( markdown: 'emails.app.guest.newsletter.verification-mail', with: [ 'newsletterUser' => $this->newsletterUser, 'signedUrl' => $signedUrl, 'homepageUrl' => route('homepage', ['language' => 'en']), ], ); } } Zde není potřeba detailněji rozebírat ukázku kódu, využijeme poskytnutá data a nastavíme předmět emailu. Vytvoření Livewire komponenty Livewire je vynikající nástroj pro tvorbu dynamických komponent v Laravelu, který umožňuje snadno spojit JavaScript a PHP. Jeho hlavní výhodou je, že nevyžaduje znalost JavaScriptu a vše můžeme řešit přímo v PHP. V našem případě využijeme Livewire komponentu pro tvorbu formuláře pro přihlášení k odběru newsletteru. Nejdříve vytvoříme novou Livewire komponentu pomocí Artisan příkazu: php artisan make:livewire NewSubscriberForm Tímto vytvoříme dva nové soubory - NewSubscriberForm.php a new-subscriber-form.blade.php. První je třída, kde definujeme logiku komponenty. Druhá je šablona, která popisuje, jak komponenta vypadá. V NewSubscriberForm.php třídě definujeme dva veřejné atributy - $email a $language, které představují hodnoty zadané uživatelem v našem formuláři. Dále zde musíme vytvořit metodu subscribe(), která se zavolá po odeslání formuláře. <?php namespace App\Http\Livewire\Guest\Newsletter; use App\Actions\Guest\Newsletter\CreateNewsletterUserAction; use App\Enums\Newsletter\NewsletterLanguage; use App\Mail\App\Guest\Newsletter\NewsletterVerificationMail; use Illuminate\Support\Facades\Mail; use Illuminate\Validation\Rules\Enum; use Livewire\Component; class NewSubscriberForm extends Component { public string $email = ''; public string $language = ''; public function render() { return view('livewire.guest.newsletter.subscription-form'); } public function subscribe() { $validatedData = $this->validate([ 'email' => 'required|email|max:128|unique:newsletter_users,email', 'language' => [ 'required', 'string', 'max:6', new Enum(NewsletterLanguage::class), ], ]); $newsletterUser = (new CreateNewsletterUserAction())->execute($validatedData); // Send verification email Mail::to($this->email) ->locale($this->language) ->send(new NewsletterVerificationMail($newsletterUser)); $this->reset('email'); $this->dispatchBrowserEvent('alert',[ 'type'=> 'success', 'message'=> __('template.newsletter-waiting-for-validation') ]); } } V metodě subscribe() ověřujeme, zda jsou vstupní data validní. Pokud nejsou, Livewire automaticky zobrazí chybové hlášky v naší šabloně. Nakonec tedy v souboru new-subscriber-form.blade.php vytvoříme naši šablonu pro formulář: <div> <div class="items-top mb-3 space-y-4 sm:flex sm:space-y-0 max-w-4xl"> <div class="relative w-full mr-1"> <label for="newsletter_email" class="hidden mb-2 text-sm font-medium text-gray-900 dark:text-gray-300"> {{ __('template.newsletter-email-label') }} </label> <div class="flex absolute inset-y-0 left-0 items-center pl-3 pointer-events-none"> <svg class="w-5 h-5 text-gray-500 dark:text-gray-400" fill="currentColor" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg"><path d="M2.003 5.884L10 9.882l7.997-3.998A2 2 0 0016 4H4a2 2 0 00-1.997 1.884z"></path><path d="M18 8.118l-8 4-8-4V14a2 2 0 002 2h12a2 2 0 002-2V8.118z"></path></svg> </div> <input wire:model.defer="email" class="block p-3 pl-10 w-full text-sm text-gray-900 bg-gray-50 rounded-lg border border-gray-300 sm:rounded-none sm:rounded-l-lg focus:ring-primary-500 focus:border-primary-500 dark:bg-gray-700 dark:border-gray-600 dark:placeholder-white dark:text-white dark:focus:ring-primary-500 dark:focus:border-primary-500" placeholder="{{ __('template.newsletter-email-placeholder') }}" type="email" id="newsletter_email"> @error('email') <p class='mt-2 text-sm text-red-600'>{{ $message }}</p> @enderror </div> <div class="relative w-full md:w-80 mr-1"> <label for="newsletter_language" class="hidden mb-2 text-sm font-medium text-gray-900 dark:text-gray-300"> {{ __('template.newsletter-language-label') }} </label> <select wire:model.defer="language" id="newsletter_language" class="bg-gray-50 border border-gray-300 text-gray-900 rounded-lg text-sm focus:ring-blue-500 focus:border-blue-500 block w-full p-3 dark:bg-gray-700 dark:border-gray-600 dark:placeholder-gray-400 dark:text-white dark:focus:ring-blue-500 dark:focus:border-blue-500"> @foreach (config('app.locales') as $lang => $language) <option value="{{ $lang }}">{{ __('template.' . $lang) }}</option> @endforeach </select> @error('language') <p class='mt-2 text-sm text-red-600'>{{ $message }}</p> @enderror </div> <div> <button wire:click="subscribe()" wire:loading.attr="disabled" type="submit" class="py-3 px-5 w-full text-sm font-medium text-center text-white rounded-lg border cursor-pointer bg-primary-700 border-primary-600 sm:rounded-none sm:rounded-r-lg hover:bg-primary-800 focus:ring-4 focus:ring-primary-300 dark:bg-primary-600 dark:hover:bg-primary-700 dark:focus:ring-primary-800"> {{ __('template.newsletter-subscribe-button') }} </button> </div> </div> </div> Tento kód definuje formulář pro zadání emailu a výběr jazyka. Používáme zde příkaz wire:model, který nám umožňuje dvoucestnou databázovou vazbu mezi PHP a HTML. Také používáme wire:submit.prevent="subscribe" pro odeslání formuláře a zavolání naší metody subscribe(). A to je vše, co potřebujeme pro vytvoření naší Livewire komponenty. Jak na její integraci do stránky a další kroky se dozvíte níže. Implementace Livewire komponenty do šablony Použití Livewire komponenty ve vaší aplikaci Laravel je přímočaré a snadné. Ve vašem Blade šablonovacím souboru jednoduše použijete direktivu @livewire. Tato direktiva přijímá jako první parametr jméno Livewire komponenty, kterou chcete vložit, a jako druhý parametr můžete předat pole s daty, která chcete komponentě předat. <section class="mb-4 md:mb-8"> <div class="mx-auto"> <h2 class="mb-2 text-xl tracking-tight font-extrabold text-gray-900 sm:text-2xl dark:text-white"> {{ __('template.newsletter-headline') }} </h2> <p class="mx-auto mb-2 font-light text-gray-500 sm:text-xl dark:text-gray-400"> {{ __('template.newsletter-description') }} </p> @livewire('guest.newsletter.new-subscriber-form', ['language' => app()->getLocale()]) </div> </section> V příkladu guest.newsletter.new-subscriber-form je jméno naší komponenty a ['language' => app()->getLocale()] jsou data, která předáváme komponentě - konkrétně jazyk, na kterém se uživatel momentálně nachází. Díky tomuto jednoduchému zápisu můžeme komponentu snadno použít kdekoliv ve vašem projektu. Nastavení trasování Trasování (routing) je klíčovým prvkem jakékoliv webové aplikace. Laravel poskytuje skvělou podporu pro definování tras pro vaše aplikace. V našem případě potřebujeme definovat pouze jednu trasu: Trasa pro ověření emailové adresy uživatele. Trasu definujeme v souboru routes/web.php. ... Route::group([ 'prefix' => "{language}", 'where' => ['language' => '[a-zA-Z]{2}'] ], function () { Route::get('/newsletter/verify/{token}', [NewsletterUserController::class, 'verify']) ->name('newsletter.verify-user') ->middleware('signed'); }); ... Poznámka: Bylo by možné použít 2 trasy - pro ověření emailové adresy uživatele a druhou trasu přímo pro Livewire komponentu. V našem případě využíváme tzv. signovanou trasu, která umožňuje vytvářet odkazy, které jsou bezpečné proti "padělání". Tato trasa vede k metodě verify v našem NewsletterVerificationController. Překlady a internacionalizace Laravel poskytuje mocný nástroj pro internacionalizaci vašich aplikací. Díky tomu můžete jednoduše vytvářet aplikace, které podporují více jazyků. Pro náš newsletter systém budeme potřebovat několik překladů. Překlady v Laravelu jsou organizovány do souborů, které se nachází v adresáři resources/lang. Každý jazyk má svůj vlastní adresář a v něm jsou umístěny soubory s překlady. V našem případě budeme potřebovat překlady pro dvě jazyky, češtinu a angličtinu. Vytvoříme tedy dva soubory: resources/lang/cs/template.php resources/lang/en/template.php V těchto souborech definujeme překlady, které použijeme v našem systému pro přihlášení k odběru newsletteru. Každý soubor obsahuje pole, kde klíč představuje identifikátor překladu a hodnota je samotný překlad. Ukázka pro český překlad: <?php return [ ... 'newsletter-headline' => "Přihlašte se k odběru novinek", 'newsletter-description' => "Přihlaste se k odběru novinek o AI, Laravelu, SEO a mnoho dalšího.", 'newsletter-email-label' => "Email", 'newsletter-email-placeholder' => "Zadejte svůj email", 'newsletter-language-label' => "Jazyk", 'newsletter-subscribe-button' => "Odebírat", 'newsletter-waiting-for-validation' => "Na váš e-mailový účet byl odeslán ověřovací odkaz.", 'newsletter-invalid-token' => "Neplatný token.", 'newsletter-successfuly-verified' => "Úspěšně ověřeno.", 'newsletter-email-verification-subject' => "Ověřte prosím svou emailovou adresu", 'newsletter-email-verification-headline' => "Vítejte v mém Newsletteru!", 'newsletter-email-verification-description' => "Děkujeme, že jste se přihlásili k odběru mého newsletteru. Kliknutím na tlačítko níže ověřte svou e-mailovou adresu a dokončete odebírání novinek.", 'newsletter-email-verification-verify-button' => "Ověřit email", 'newsletter-email-verification-homepage-button' => "Přejít na web", 'newsletter-email-verification-thanks' => "Děkuji", ... ]; Ukázka pro anglický překlad: <?php return [ ... 'newsletter-headline' => "Sign up for newsletter", 'newsletter-description' => "Sign up for news on AI, Laravel, SEO and much more.", 'newsletter-email-label' => "Email address", 'newsletter-email-placeholder' => "Enter your email", 'newsletter-language-label' => "Language", 'newsletter-subscribe-button' => "Subscribe", 'newsletter-waiting-for-validation' => "A verification link has been sent to your email account.", 'newsletter-invalid-token' => "Invalid token.", 'newsletter-successfuly-verified' => "Successfully verified.", 'newsletter-email-verification-subject' => "Please verify your email address", 'newsletter-email-verification-headline' => "Welcome to my Newsletter!", 'newsletter-email-verification-description' => "Thank you for subscribing to my newsletter. Click the button below to verify your email address and complete your newsletter subscription.", 'newsletter-email-verification-verify-button' => "Verify email", 'newsletter-email-verification-homepage-button' => "Go to website", 'newsletter-email-verification-thanks' => "Thanks", ... ]; Tyto překlady poté můžeme využít v našich šablonách nebo kódu pomocí helperu __ - jak již bylo ukázáno v předchozích částech kódu. __('template.newsletter-email-verification-subject') Tímto způsobem můžeme přidávat další jazyky do naší aplikace pouze přidáním dalších souborů s překlady. Laravel za nás automaticky vybere správný jazyk podle nastavení aplikace (což není obsahem tohoto článku). Testování systému pomocí Pest Když máme hotový systém pro přihlašování uživatelů k odběru newsletteru, je důležité se ujistit, že všechny jeho části fungují správně. K tomu slouží automatizované testy. V Laravelu je pro testování populární nástroj Pest. Pest je elegantní wrapper nad PHPUnit, který umožňuje psát testy deklarativním stylem, který je často čitelnější a snazší na pochopení. Pest umožňuje testovat všechny části naší aplikace. Můžeme testovat, zda se naše routy chovají správně, zda se data správně ukládají do databáze, nebo zda se odesílají správné e-maily. Pro testování našeho newsletter systému vytvoříme dva testy: Test pro ověření uživatele newsletteru. Test pro odběr nových uživatelů pomocí Livewire komponenty. V těchto testech ověříme, zda se uživatelé mohou přihlasit k newsletteru a ověřují, zda se odesílají ověřovací e-maily a zda se správně zobrazují flash zprávy. Otestování Livewire komponenty - NewSubscriberFormTest.php: <?php use App\Enums\Newsletter\NewsletterLanguage; use App\Http\Livewire\Guest\Newsletter\NewSubscriberForm; use App\Mail\App\Guest\Newsletter\NewsletterVerificationMail; use App\Models\Newsletter\NewsletterUser; use Illuminate\Support\Facades\Mail; use Livewire\Livewire; it('subscribes a new user to the newsletter and sends a verification email', function () { Mail::fake(); Livewire::test(NewSubscriberForm::class) ->set('email', 'test@example.com') ->set('language', NewsletterLanguage::ENGLISH->value) ->call('subscribe') ->assertDispatchedBrowserEvent('alert'); expect(NewsletterUser::where('email', 'test@example.com')->first()) ->email->toEqual('test@example.com') ->language->toEqual(NewsletterLanguage::ENGLISH) ->is_verified->toBeFalse(); Mail::assertSent(NewsletterVerificationMail::class, function ($mail) { return $mail->newsletterUser->email === 'test@example.com' && $mail->newsletterUser->language === NewsletterLanguage::ENGLISH; }); }); it('validates the new user subscription input data', function () { Livewire::test(NewSubscriberForm::class) ->set('email', 'invalid-email') ->set('language', 'invalid-language') ->call('subscribe') ->assertHasErrors(['email', 'language']); }); Otestování řadiče - NewsletterUserControllerTest.php: <?php use App\Models\Newsletter\NewsletterUser; use Illuminate\Support\Facades\Config; use Illuminate\Support\Facades\URL; it('verifies a newsletter user successfully and redirects to the homepage with a success flash message', function () { $newsletterUser = NewsletterUser::factory()->create(); $response = $this->get(URL::signedRoute('newsletter.verify-user', [ 'language' => $newsletterUser->language, 'token' => $newsletterUser->verification_token ])); $response->assertStatus(302); $response->assertRedirect(route('homepage', ['language' => $newsletterUser->language])); $response->assertSessionHas('flashType', 'success'); $response->assertSessionHas('flashMessage', __('template.newsletter-successfuly-verified')); $newsletterUser->refresh(); expect($newsletterUser->is_verified)->toBeTrue(); }); it('fails to verify a newsletter user for an invalid token and redirects to the homepage with an error flash message', function () { $response = $this->get(URL::signedRoute('newsletter.verify-user', [ 'language' => Config::get('translatable.fallback_locale'), 'token' => 'invalidtoken' ])); $response->assertStatus(302); $response->assertRedirect(route('homepage', ['language' => Config::get('translatable.fallback_locale')])); $response->assertSessionHas('flashType', 'error'); $response->assertSessionHas('flashMessage', __('template.newsletter-invalid-token')); expect(NewsletterUser::where('is_verified', true)->count())->toBe(0); }); Pro testování rout a HTTP odpovědí nám Pest poskytuje řadu metod pro přiřazování jako assertStatus, assertRedirect nebo například assertSessionHas. Pro ověření stavu v databázi můžeme využít metodu assertDatabaseHas. Při psaní testů je důležité myslet na to, aby testy pokrývaly všechny možné scénáře a aby byly nezávislé na sobě. To znamená, že každý test by měl mít svůj vlastní izolovaný stav a neměl by ovlivňovat výsledky ostatních testů. Práce s akcemi Akce v Laravelu nám pomáhají udržet náš kód organizovaný a zároveň zajistit, že každá operace je jednoznačně definována. V našem systému pro přihlášení k odběru newsletteru jsme vytvořili dvě klíčové akce - CreateNewsletterUserAction a VerifyNewsletterUserAction, které jsme ve článku nijak nerozebírali. CreateNewsletterUserAction se stará o vytvoření nového uživatele v naší databázi newsletteru. Zde dochází k zápisu e-mailu a jazyka, který si uživatel vybral pro odběr novinek. <?php namespace App\Actions\Guest\Newsletter; use App\Models\Newsletter\NewsletterUser; class CreateNewsletterUserAction { public function execute(array $validatedData): NewsletterUser { return NewsletterUser::create($validatedData); } } VerifyNewsletterUserAction poté ověřuje uživatele na základě tokenu, který obdržel v ověřovacím e-mailu. Tato akce také nastavuje příznak is_verified na true po úspěšném ověření. <?php namespace App\Actions\Guest\Newsletter; use App\Models\Newsletter\NewsletterUser; class VerifyNewsletterUserAction { public function execute(NewsletterUser $newsletterUser): NewsletterUser { $newsletterUser->update([ 'is_verified' => true, 'verification_token' => null ]); return $newsletterUser; } } Tyto dvě akce ukazují, jak můžeme efektivně organizovat naše operace v Laravelu. Usnadňují nám do budoucna škálovatelnost našeho systému pro newslettery. Využití Enum pro jazykové nastavení Enumerátor NewsletterLanguage nám poskytuje elegantní a bezpečný způsob, jak manipulovat s jazykovými kódy v naší aplikaci. Pomocí Enum máme jistotu, že budeme pracovat pouze s povolenými hodnotami - v našem případě en pro angličtinu a cs pro češtinu. Použití Enum také zvyšuje čitelnost kódu a usnadňuje údržbu, jelikož všechny možné hodnoty jsou centralizovány na jednom místě. <?php namespace App\Enums\Newsletter; use Illuminate\Support\Collection; enum NewsletterLanguage: string { case ENGLISH = 'en'; case CZECH = 'cs'; public static function all(): Collection { return collect(NewsletterLanguage::cases())->map( fn(NewsletterLanguage $code) => $code->details() ); } public function details(): array { return match($this) { self::ENGLISH => [ 'name' => 'English', 'value' => 'en', ], self::CZECH => [ 'name' => 'Czech', 'value' => 'cs', ], }; } } Metody all a details pak umožňují snadno získat všechny dostupné jazyky a jejich podrobnosti, což je užitečné například při naplnění výběrového pole jazyků ve formuláři. Domácí úkol Využití enumerátoru v Livewire komponentěV šabloně u Livewire komponenty jsem pro výčet jazyků použil iteraci nad polem uvedeným v konfiguračním souboru, konkrétně v app.php - config('app.locales'). V produkci by však bylo ideálním použít enum.Nápověda: Pročpak máme v enumerátoru metodu all()? Nešla by využít? Ošetření validačních zprávLivewire komponenta není celá přeložena. Laravel nám pro chybové hlášky dokáže vypsat zprávy v angličtině, nikoliv však v češtině.Nápověda: Livewire má pěkne popsanou dokumentaci a s využitím dokumentace od Laravelu by měl být tento úkol snadno vyřešitelný. Vytvoření seederuPokud chcete mít naplněnou databázi náhodně generovanými daty a nechcete se spoléhat pouze na testy, určitě využijete seeder. To také usnadní dalším vývojářům pochopit Vaši aplikaci bez nutnosti vytvářet data ručně.Nápověda: Jelikož máme továrnu pro tvorbu instancí modelu včetně ukázky použití v testu, nemělo by Vám nic dělat problémy. Odesílejte mail ve frontěAby uživatel nečekal, než se funkce vykoná (odešle se email), můžete u emailu použít zpracování přes tzv fronty.Nápověda: Laravel má opět vše pěkně shrnuté v dokumentaci. Osobně doporučuji "implementovat" v souboru pro logiku emailu využití front (aneb jediná třída, která není použita v naší ukázce, přesto ji soubor obsahuje - dokonce je přidána, pokud soubor generujete přes artisan příkaz). Závěr Vytvoření systému pro přihlášení k odběru newsletteru v Laravelu může vypadat jako složitá úloha. Tento článek by Vám měl ukázat, že to ale není tak složité, jak by se mohlo na první pohled zdát. Díky tomuto průvodci jste měli možnost seznámit se s celým procesem od základní přípravy přes implementaci jednotlivých částí až po testování. Laravel je výkonný a flexibilní framework, který umožňuje vytvářet různé typy webových aplikací. Pomocí Livewire můžeme snadno vytvářet dynamické komponenty a díky Pestu můžeme efektivně testovat naši aplikaci a ujistit se, že vše funguje správně. Důležité je také pamatovat na internacionalizaci a připravit naši aplikaci pro vícejazyčné uživatele. Laravel nabízí skvělé nástroje pro práci s překlady a lokalizací. Doufám, že vám tento průvodce pomohl porozumět, jak v Laravelu vytvořit systém pro přihlášení k odběru newsletteru a že vás inspiroval k dalším projektům. Pamatujte, že nejdůležitější je praktická zkušenost, takže neváhejte a pusťte se do vlastního projektu!]]> https://www.pavelzanek.com/cs/blog/factory-astrotomic-laravel-translatable https://www.pavelzanek.com/cs/blog/factory-astrotomic-laravel-translatable Sun, 18 Jun 2023 00:00:00 +0200 $this->faker->word, // other attributes... ]; } ... V metodě definition() využíváme tzv. Faker knihovnu, která nám umožňuje generovat různé typy náhodných dat, jako jsou slova, věty, čísla a jiná data. Nyní, když máte vytvořenou továrnu, můžete ji použít k vytvoření dat pro vaše testy. To můžete udělat například takto: $user = UserFactory::new()->create(); Tímto způsobem vytvoříte nový záznam v databázi s daty generovanými vaší továrnou. Továrny v Laravelu jsou mocným nástrojem, který vám umožní snadno a efektivně generovat testovací data pro vaše aplikace. Jak používat balíček Astrotomic/laravel-translatable pro překlady Balíček Astrotomic/laravel-translatable je nástroj, který umožňuje snadné překlady vašich modelů v Laravelu. Tento balíček je ideální pro projekty, které vyžadují vícejazyčnou podporu, a umožňuje vám ukládat překlady vašich modelů přímo v databázi. Abychom mohli balíček používat, musíme ho nejprve nainstalovat. To lze provést pomocí následujícího příkazu: composer require astrotomic/laravel-translatable Po instalaci balíčku musíme v našem modelu, který chceme překládat, použít trait Translatable. Trait přidává metody, které nám umožňují snadno pracovat s překlady. ... use Astrotomic\Translatable\Translatable; class Post extends Model { use Translatable; public $translatedAttributes = ['title', 'body']; ... } V tomto příkladu jsme v modelu Post použili trait Translatable a definujeme, že atributy title a body budou překládány. Kromě trait můžeme také přidat contract: ... use Astrotomic\Translatable\Contracts\Translatable as TranslatableContract; use Astrotomic\Translatable\Translatable; class Post extends Model implements TranslatableContract { use Translatable; public $translatedAttributes = ['title', 'body']; ... } Balíček Astrotomic/laravel-translatable nám pak umožňuje snadno přistupovat k překladům a pracovat s nimi. Například takto: $post = Post::first(); echo $post->translate('en')->title; // this will print the English title of the post Balíček Astrotomic/laravel-translatable je mocný nástroj pro práci s překlady v Laravelu. V následující části se podíváme na to, jak ho můžeme využít při vytváření továren. Vytváření továrny pro modely s balíčkem Astrotomic/laravel-translatable Nyní, když máme základní představu o tom, jak funguje balíček Astrotomic/laravel-translatable, můžeme se podívat na to, jak vytvořit továrnu pro modely, které tento balíček využívají. Představme si, že máme model Post, který používá balíček Astrotomic/laravel-translatable pro překlady atributů title a body. Jak bychom pro tento model vytvořili továrnu? První krok je stejný, jako jsme si ukázali v předchozí části - vytvoříme továrnu pomocí příkazu Artisan: php artisan make:factory PostFactory --model=Post Následně otevřeme soubor továrny a upravíme metodu definition() tak, aby generovala překlady pro naše atributy. To můžeme udělat například takto: ... public function definition() { $locales = ['en', 'cs']; $translations = collect($locales)->mapWithKeys(function($locale) { return [ $locale => [ 'title' => $this->faker->words(3, true), 'body' => $this->faker->realText(500), ... ] ]; })->toArray(); return array_merge($translations, [ 'type' => PostType::POST, // non-translatable attribute ]); } ... V tomto příkladu generujeme překlady pro angličtinu (en) a češtinu (cs) pomocí Faker knihovny. Můžeme přidat tolik jazyků, kolik potřebujeme. Nyní, když máme vytvořenou továrnu, můžeme ji použít k vytvoření dat pro naše testy stejným způsobem, jak jsme si ukázali v předchozí části. Tímto způsobem můžeme snadno vytvářet továrny pro modely, které používají balíček Astrotomic/laravel-translatable pro překlady. Závěr V tomto článku jsme se podrobně seznámili s procesem vytváření továrny pro modely v Laravelu s použitím balíčku Astrotomic/laravel-translatable pro překlady. Prošli jsme si základy vytváření továrny, seznámili jsme se s balíčkem Astrotomic/laravel-translatable a nakonec jsme si ukázali, jak vytvořit továrnu pro modely, které tento balíček používají. Doufáme, že vám tento průvodce pomohl pochopit, jak efektivně využívat továrny v Laravelu a jak je kombinovat s balíčkem pro překlady. Laravel je mocný framework, který nabízí mnoho nástrojů a funkcí, které usnadňují vývoj webových aplikací. Továrny a balíček pro překlady jsou jen malou částí toho, co Laravel nabízí. Pokud chcete prohloubit své znalosti Laravelu a jeho funkcí, doporučuji se podívat na další zdroje a tutoriály/návody, které jsou k dispozici online. Také se nebojte experimentovat a zkoušet nové věci - to je nejlepší způsob, jak se naučit a zlepšit své dovednosti. Přeji Vám hodně úspěchů a radosti při vývoji s frameworkem Laravel!]]> https://www.pavelzanek.com/cs/blog/title https://www.pavelzanek.com/cs/blog/title Wed, 14 Jun 2023 00:00:00 +0200 https://www.pavelzanek.com/cs/blog/structured-data https://www.pavelzanek.com/cs/blog/structured-data Wed, 07 Jun 2023 00:00:00 +0200 https://www.pavelzanek.com/cs/blog/chatgpt https://www.pavelzanek.com/cs/blog/chatgpt Tue, 06 Jun 2023 00:00:00 +0200 https://www.pavelzanek.com/cs/blog/new-laravel-application-homestead https://www.pavelzanek.com/cs/blog/new-laravel-application-homestead Sun, 05 Dec 2021 00:00:00 +0100 Otevřít… (CTRL+O) a přejdeme do složky „C:\Windows\System32\drivers\etc". Nezapomeňte si zobrazit všechny soubory, pokud vidíte pouze .txt soubory: Vidíme tedy všechny soubory ve složce a otevřeme si soubor „hosts". Nyní přidáme: ... 192.168.10.10 vase-laravel-aplikace.test ... Tedy namapovali jsme IP adresu našeho budoucího Homesteadu na URL adresu. Pokud zadáme posléze URL adresu do prohlížeče, požadavky budou nasměrovány na Homestead – pojďme si jej tedy nastavit. Nastavení souboru Homestead.yaml Přejděte do složky, kde máte nainstalovaný Homestead a otevřete soubor Homestead.yaml. Podívejte se na ukázku, jak by takový Váš Homestead.yaml mohl vypadat. --- ip: "192.168.10.10" memory: 512 cpus: 1 provider: virtualbox ssl: true authorize: c:/Users/***/.ssh/vas-public-key.pub keys: - c:/Users/***/.ssh/vas-private-key.ppk folders: - map: d:/laravel-websites to: /home/vagrant/code sites: - map: vase-laravel-aplikace.test to: /home/vagrant/code/vase-laravel-aplikace.test/public php: '8.0' databases: - vase_db_k_aplikaci features: - mysql: false - mariadb: true - postgresql: false - ohmyzsh: false - webdriver: false # ports: # - send: 50000 # to: 5000 # - send: 7777 # to: 777 # protocol: udp Za povšimnutí stojí více věcí, pojďme se na ně podívat. IP adresa – stejnou jsme použili v souboru hosts folders – musíme namapovat, kde se aplikace vyskytuje. V mém případě používám disk „D:\", ve kterém mám složku „laravel-websites". Celá tato složka se mi dostane na Homestead pod „/home/vagrant/code". databases – rovnou můžeme vytvořit db pro naší aplikaci na ukázku jsem navíc uvedl, jak můžete k Homestead přistupovat pod SSH. Instalace Laravelu pomocí instalátoru Nyní už víme, na jaké URL adrese postavíme aplikaci. Dále víme, že pokud zadáme URL do prohlížeče, dostaneme se díky namapování na Homestead. Homestead je pak nakonfigurován tak, že si stáhne obsah z lokální složky „D:\laravel-websites" a umístí jej do „/home/vagrant/code". Dále ale víme, že zde hledáme konkrétně /home/vagrant/code/vase-laravel-aplikace.test/public. Takže si musíme Laravel aplikaci nainstalovat. Přejdeme tedy pomocí příkazové řádky do „D:\laravel-websites" a spustíme: laravel new vase-laravel-aplikace.test Po dokončení by měl výsledek skončit podobně jako zde: Spuštění Homesteadu s novou konfigurací Nyní musíme spustit Homestead včetně naší nové konfigurace. Přejděte tedy v příkazové řádce do umístění, kde máte nainstalovaný Homestead a spusťte: vagrant up --provision Případně, pokud již máte zapnutý Homestead, můžete použít (nemusíte tedy Homestead vypínat přes „vagrant halt") vagrant reload --provision Důležité je, že se použije přepínač –provision, který spustí Homestead s novou konfigurací. TIP Pokud se chcete přihlásit do Homesteadu pomocí SSH, postačí spustit z nainstalované složky z Homesteadem: vagrant ssh Posléze se můžete dostat do Vaší aplikace: cd code/vase-laravel-aplikace.test V Homesteadu pak ve složce s projektem můžete provádět například příkazy všeho druhu (migrace, vygenerování assetů, instalace packages, …). Závěrem Nyní už si stačí projekt přidat do Vašeho IDE a upravit .env. Jakmile si nakonfigurujete, v prohlížeči už můžete zadat URL projektu a uvidíte novou Laravel aplikaci. Pak už jen stačí vytvořit něco skvělého.]]> https://www.pavelzanek.com/cs/blog/laravel-application-localization https://www.pavelzanek.com/cs/blog/laravel-application-localization Sat, 20 Nov 2021 00:00:00 +0100 [ 'en' => 'English', 'cs' => 'Czech', ], ... Middleware Language app/Http/Middleware/Language.php: <?php namespace App\Http\Middleware; use Closure; use Illuminate\Http\Request; use Illuminate\Support\Facades\App; use Illuminate\Support\Facades\URL; class Language { /** * Handle an incoming request. * * @param \Illuminate\Http\Request $request * @param \Closure $next * @return mixed */ public function handle(Request $request, Closure $next) { App::setLocale($request->language); URL::defaults(['language' => $request->language]); $request->route()->forgetParameter('language'); return $next($request); } } Přidání middlewaru do kernelu app/Http/Kernel.php: ... protected $middlewareGroups = [ 'web' => [ \App\Http\Middleware\Language::class, // Localization ], ... ]; ... Routy ve web.php routes/web.php: ... Route::group([ 'prefix' => "{language}", 'where' => ['language' => '[a-zA-Z]{2}'] ], function () { ... }); ... Kontroler LanguageController.php app/Http/Controllers/LanguageController.php: <?php namespace App\Http\Controllers; use Illuminate\Http\Request; use Illuminate\Support\Facades\App; use Illuminate\Support\Facades\URL; class LanguageController extends Controller { public function switchLang(Request $request, $lang) { // $urlParts[1] == current lang $urlParts = explode('/', str_ireplace(array('http://', 'https://'), '', url()->previous())); $newUrl = str_replace( '/' . $urlParts[1] . '/', '/' . $lang . '/', url()->previous() ); App::setLocale($lang); URL::defaults(['language' => $lang]); return redirect()->to($newUrl); } } Přidání routy kontroleru do web.php routes/web.php: ... Route::get('lang/{lang}', [App\Http\Controllers\LanguageController::class, 'switchLang'])->name('langSwitcher'); ... RouteServiceProvider.php app/Providers/RouteServiceProvider.php: ... public const DASHBOARD = '/en/dashboard'; ... Vytvoření Language switcheru Příklad pro použití ve stacku: Laravel, Jetstream – Livewire + Blade, Tailwindcss resources/views/navigation-menu.blade.php: Desktop ... <!-- Language Dropdown --> <div class="ml-3 relative"> <x-jet-dropdown align="right" width="48"> <x-slot name="trigger"> <span class="inline-flex rounded-md"> <button type="button" class="inline-flex items-center px-3 py-2 border border-transparent text-sm leading-4 font-medium rounded-md text-gray-500 bg-white hover:text-gray-700 focus:outline-none transition"> @lang(config('app.locales')[App::getLocale()]) <svg class="ml-2 -mr-0.5 h-4 w-4" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor"> <path fill-rule="evenodd" d="M5.293 7.293a1 1 0 011.414 0L10 10.586l3.293-3.293a1 1 0 111.414 1.414l-4 4a1 1 0 01-1.414 0l-4-4a1 1 0 010-1.414z" clip-rule="evenodd" /> </svg> </button> </span> </x-slot> <x-slot name="content"> <!-- Language Switcher --> <div class="block px-4 py-2 text-xs text-gray-400"> {{ __('Select language') }} </div> @foreach (config('app.locales') as $lang => $language) @if ($lang !== App::getLocale()) <x-jet-dropdown-link href="{{ route('langSwitcher', $lang) }}"> @lang($language) </x-jet-dropdown-link> @endif @endforeach </x-slot> </x-jet-dropdown> </div> ... Responzivní verze ... <div class="mt-3 space-y-1"> <div class="border-t border-gray-200"></div> <div class="block px-4 py-2 text-xs text-gray-400"> {{ __('Select language') }} </div> @foreach (config('app.locales') as $lang => $language) @if ($lang !== App::getLocale()) <x-jet-responsive-nav-link href="{{ route('langSwitcher', $lang) }}"> @lang($language) </x-jet-responsive-nav-link> @endif @endforeach <div class="border-t border-gray-200"></div> </div> ... Doplnění překladů Například resources/lang/cs.json: { "Dashboard": "Nástěnka", "Select language": "Vyberte jazyk", "Czech": "Čeština", ... } Výsledek Česká verze: Anglická verze: Tip Pokud používáte Jetstream spolu s Livewire jako v příkladu a chcete defaultní routy lokalizovat, pak musíte udělat ještě několik menších úprav. Ze složky /vendor/jetstream/routes/ překopírujte routy k Vašim routám. Soubor pak může vypadat následovně (routes/web.php): <?php use Illuminate\Support\Facades\Route; use Laravel\Jetstream\Http\Controllers\CurrentTeamController; use Laravel\Jetstream\Http\Controllers\Livewire\ApiTokenController; use Laravel\Jetstream\Http\Controllers\Livewire\PrivacyPolicyController; use Laravel\Jetstream\Http\Controllers\Livewire\TeamController; use Laravel\Jetstream\Http\Controllers\Livewire\TermsOfServiceController; use Laravel\Jetstream\Http\Controllers\Livewire\UserProfileController; use Laravel\Jetstream\Http\Controllers\TeamInvitationController; use Laravel\Jetstream\Jetstream; Route::get('lang/{lang}', [App\Http\Controllers\LanguageController::class, 'switchLang'])->name('langSwitcher'); Route::get('/', function () { return redirect()->route('login'); }); Route::group([ 'prefix' => "{language}", 'where' => ['language' => '[a-zA-Z]{2}'] ], function () { Route::group(['middleware' => config('jetstream.middleware', ['web'])], function () { if (Jetstream::hasTermsAndPrivacyPolicyFeature()) { Route::get('/terms-of-service', [TermsOfServiceController::class, 'show'])->name('terms.show'); Route::get('/privacy-policy', [PrivacyPolicyController::class, 'show'])->name('policy.show'); } Route::group(['middleware' => ['auth:sanctum', 'verified']], function () { Route::get('/user/profile', [UserProfileController::class, 'show']) ->name('profile.show'); if (Jetstream::hasApiFeatures()) { Route::get('/user/api-tokens', [ApiTokenController::class, 'index'])->name('api-tokens.index'); } if (Jetstream::hasTeamFeatures()) { Route::get('/teams/create', [TeamController::class, 'create'])->name('teams.create'); Route::get('/teams/{team}', [TeamController::class, 'show'])->name('teams.show'); Route::put('/current-team', [CurrentTeamController::class, 'update'])->name('current-team.update'); Route::get('/team-invitations/{invitation}', [TeamInvitationController::class, 'accept']) ->middleware(['signed']) ->name('team-invitations.accept'); } }); }); Route::group(['middleware' => ['auth:sanctum', 'verified']], function () { Route::get('/dashboard', function () { return view('dashboard'); })->name('dashboard'); }); }); Pokud bychom upravili například routu pro zobrazení profilu, například takto (routes/web.php): ... // Old value: /user/profile Route::get('/profile', [UserProfileController::class, 'show'])->name('profile.show'); ... Pokud uděláme výše uvedenou změnu, zobrazení profilu bude dostupné jak na naší routě /profile, tak i můžeme využít výchozí routu /user/profile (načítanou z package – laravel/jetstream/routes/livewire.php). Pokud chceme výchozí routy vypnout, pak musíme upravit JetsreamServiceProvider.php (app/Providers/JetsreamServiceProvider.php). ... public function register() { Jetstream::ignoreRoutes(); } ...]]> https://www.pavelzanek.com/cs/blog/page-indexing https://www.pavelzanek.com/cs/blog/page-indexing Thu, 30 Nov 2017 00:00:00 +0100 https://www.pavelzanek.com/cs/blog/automatically-generated-content https://www.pavelzanek.com/cs/blog/automatically-generated-content Sat, 19 Aug 2017 00:00:00 +0200 https://www.pavelzanek.com/cs/blog/correct-landing-page https://www.pavelzanek.com/cs/blog/correct-landing-page Wed, 31 May 2017 00:00:00 +0200 https://www.pavelzanek.com/cs/blog/data-collection-keyword-research-part-1 https://www.pavelzanek.com/cs/blog/data-collection-keyword-research-part-1 Sat, 22 Apr 2017 00:00:00 +0200 https://www.pavelzanek.com/cs/blog/keyword-research https://www.pavelzanek.com/cs/blog/keyword-research Sat, 22 Apr 2017 00:00:00 +0200