Laravel Enum: Чистый, структурированный и удобный для разработчиков

Теперь Laravel поддерживает нативные классы Enum со встроенными функциями кастинга, меток и генерации через Artisan. Это отличный способ избавиться от "магических" строк и чисел в моделях и формах.

🔧 Создание Enum через Artisan:

php artisan make:enum UserRole

📁 Создастся файл: app/Enums/UserRole.php

📦 Пример класса Enum:

namespace App\Enums;

enum UserRole: string
{
    case Admin = 'admin';
    case Manager = 'manager';
    case Customer = 'customer';

    public function label(): string
    {
        return match($this) {
            self::Admin => 'Администратор',
            self::Manager => 'Менеджер',
            self::Customer => 'Клиент',
        };
    }

    public static function options(): array
    {
        return array_map(
            fn($role) => ['value' => $role->value, 'label' => $role->label()],
            self::cases()
        );
    }
}

✅ Как использовать:

📌 Приведение типов в модели:

protected $casts = [
    'role' => UserRole::class,
];

📌 Работа с Enum:

$user->role = UserRole::Admin;
echo $user->role->label(); // "Администратор"

📌 Генерация <select> (Blade или Livewire):

<select name="role">
    @foreach (App\Enums\UserRole::options() as $option)
        <option value="{{ $option['value'] }}">{{ $option['label'] }}</option>
    @endforeach
</select>

📌 Валидация ввода:

'role' => ['required', new Enum(UserRole::class)],

📌 Laravel Enums делают код чище, улучшают его читаемость и уменьшают количество ошибок, связанных с недопустимыми значениями. Используйте make:enum, для быстрого создания, и расширяйте функциональность по мере необходимости.

📱 @dev_notes_ru

#Laravel

👩‍💻 Что такое this в JavaScript

Во второй части серии Mat Marquis объясняет, что такое this на самом деле, и помогает разобраться, чему он соответствует, исходя из различных контекстов.

🖥 Читать статью

📱 @dev_notes_ru

#JavaScript

Laravel 12.6: Новый метод `requestException()` для удобной обработки ошибок HTTP-тестов

Laravel 12.6 представляет метод requestException() — более простой способ создания экземпляров RequestException при тестировании работы HTTP-клиента. Теперь можно эмулировать ошибочные ответы сервера чище и лаконичнее.

🔧 Как это работало раньше:

use Illuminate\Http\Client\RequestException;
use Illuminate\Http\Client\Response;

$exception = new RequestException(
    new Response(
        Http::response(['error' => 'invalid_token'], 401)
    )
);

✅ Теперь с `requestException()`:

use Illuminate\Support\Facades\Http;

$exception = Http::requestException(['error' => 'invalid_token'], 401);

Нужны кастомные заголовки? Просто передайте их:

$exception = Http::requestException(
    ['message' => 'Too many requests'],
    429,
    ['X-RateLimit-Reset' => '30']
);

✨ Почему это удобно:

- Меньше шаблонного кода в тестах
- Лучшая читаемость и понятность
- Упрощает поддержку и рефакторинг

📌 Метод requestException() делает HTTP-тесты чище, быстрее и выразительнее.

📱 @dev_notes_ru

#Laravel #Laravel12

👩‍💻 Мемоизация кэша в Laravel: Как работает `Cache::memo()` и зачем он нужен

Как использовать мемоизацию кэша в Laravel для повышения производительности и сокращения сетевых обращений к Redis, Memcached и другим хранилищам.

Даже если вы используете кэш, Laravel каждый раз обращается к внешнему хранилищу. Это может быть Redis или Memcached — и каждый такой запрос может занимать лишние миллисекунды. В больших приложениях это превращается в серьёзную нагрузку.

🖥 Читать статью

📱 @dev_notes_ru

#Laravel #Cache

Отключение событий при создании Eloquent моделей

При тестировании часто возникает необходимость создавать записи через модель без запуска связанных событий. Сделать это очень просто с помощью метода createQuietly.

Пример использования со стандартной моделью:

$user = User::createQuietly([
    'name' => 'Mabel',
    'email' => 'mabel@codecourse.com'
]);

Метод createQuietly не запускает никакие события, поэтому обработчики в наблюдателях моделей не сработают.

Особенно удобно при тестировании с фабриками:

User::factory(3)->createQuietly();

Этот код создаст трёх пользователей без генерации событий.

Другие варианты "тихого" создания:

- createOneQuietly() - для создания одной записи
- createManyQuietly() - для массового создания

Эти методы помогают ускорить тесты и избежать побочных эффектов при работе с моделями.

📱 @dev_notes_ru

#Laravel #Eloquent #tips

PHP разработчики vs. Хэйтеры PHP

📱 @dev_notes_ru

#joke

- Я использую C++ в JavaScript
- Покажи

📱 @dev_notes_ru

#joke

Проверка существования представления в Laravel

Если вы работаете с представлениями в Laravel напрямую и нужно заранее проверить, существует ли представление, вот как это сделать.

Это очень просто! Просто используйте метод exists класса View. В данном примере используется хелпер view.

if (view()->exists('some.view')) {
    // ...
}

Учтите, что some.view соответствует файлу /some/view.blade.php. Этот метод работает с точечной нотацией так же, как и при рендеринге представлений.

📱 @dev_notes_ru

#Laravel #View #tips

Что-то пошло не так

📱 @dev_notes_ru

#joke

В случае пожара

📱 @dev_notes_ru

#joke

Вместо добавления множества файлов в .gitignore. Мы, просто, игнорируем всё. Отслеживаемые файлы необходимо добавлять вручную с помощь. git add -f myfile

📱 @dev_notes_ru

#joke

Vibe-код - код спагетти

📱 @dev_notes_ru

#joke

Преобразуйте исключения CSRF mismatch в исключения валидации для улучшения пользовательского опыта.

Поскольку исключения валидации обычно генерируют ответ редиректа, токен CSRF должен автоматически обновляться, чтобы пользователь мог повторить попытку. 👍

📱 @dev_notes_ru

#Laravel #CSRF #tips

📱 @dev_notes_ru

#joke #git

Пятничное 🤣

📱 @dev_notes_ru

#joke

CSS `if()`: новая функция условной логики доступна в Chrome 137+

CSS с каждым днем превращается в настоящий «язык программирования». С появлением новых возможностей, таких как CSS переменные, функция `calc()`, псевдоклассы `:has()` и `:is()`, а также универсальные `@media` запросы, CSS упрощает создание сложных стилей и макетов.

В CSS появилась новая функция if(), пока доступная только в Chrome 137 и выше. Это первый шаг к условной логике прямо в стилях.

🖥 Читать статью

📱 @dev_notes_ru

#Frontend #CSS

Зачем нужны логические свойства CSS

Сегодня я хотел бы поговорить о логических свойствах CSS — новом (и, возможно, более эффективном) способе определения свойств, которые по своей природе являются направленными.

🖥 Читать статью

📱 @dev_notes_ru

#Frontend #CSS

Каст модели AsUri

Ash Allen предоставил каст модели AsUri, преобразующий значения в экземпляр Illuminate\Support\Uri и обратно.

use Illuminate\Support\Uri;
use Illuminate\Database\Eloquent\Casts\AsUri;
 
protected function casts(): array
{
    return [
        // ...
        'destination_url' => AsUri::class,
    ];
}
 
// Set a URL
$shortUrl->destination_url = new Uri('https://www.example.com:1234/hello?param=value');
$shortUrl->save();

👩‍💻 Подробности см. в Pull Request #55909.

📱 @dev_notes_ru

#Laravel #Laravel12

Агрегатные функции SQL

В статье мы рассмотрим наиболее часто используемые агрегатные функции SQL, их синтаксис, практические примеры и способы оптимального использования в запросах.

🖥 Читать статью

📱 @dev_notes_ru

#DataBase #SQL

Контекстный биндинг интерфейса через атрибуты

Yitz Willroth добавил атрибут Give, позволяющий использовать контекстные зависимости с помощью атрибутов PHP 8:

// Традиционный подход - в ServiceProvider
$this->app->when(UserController::class)
    ->needs(UserRepositoryInterface::class)
    ->give(DatabaseUserRepository::class);
 
use Illuminate\Container\Attribute\Give;
 
// Использование атрибута Give
class UserController extends Controller
{
    public function __construct(
        #[Give(DatabaseUserRepository::class)]
        private UserRepositoryInterface $userRepository
    ) {}
}
 
// Ещё один пример
class OrderService
{
    public function __construct(
        #[Give(StripePaymentProcessor::class)]
        private PaymentProcessorInterface $processor
    ) {}
}

👩‍💻 Подробности см. в Pull Request #55904.

📱 @dev_notes_ru

#Laravel #Laravel12

В Query Builder добавлен reorderDesc()

Rihulfa Akbar добавил в конструктор запросов метод reorderDesc(), являющийся сокращением для добавления в запрос условия сортировки по убыванию:

// использование reorder()
$this->reorder($column, 'desc');
 
// reorderDesc()
$query->reorderDesc($column);

👩‍💻 Подробности см. в Pull Request #55885.

📱 @dev_notes_ru

#Laravel #Laravel12