Autor: Michał

Zmienna liczba argumentów w konstruktorze

W PHP nie raz zachodzi potrzeba przechowywania w obiekcie tablicy obiektów określonego typu, np. w kolekcjach, managerach strategii, itp. Jeśli lista obiektów jest przekazywana w konstruktorze to warto sprawdzić czy są właściwego typu. Przykładowy konstruktor może wyglądać tak:

/**
 * @param Item[] $items
 * @throws InvalidArgumentException
 */
public function __construct(array $items)
{
    foreach ($items as $item) {
        if (!$item instanceof Item) {
            throw new InvalidArgumentException('Collection accepts only instances of Item');
        }
    }
    $this->items = $items;
}

Ten sam efekt można osiągnąć prościej dzięki zastosowaniu operatora … (trzy kropki):

public function __construct(Item ...$items)
{
    $this->items = $items;
}

Tworzenie pokazu slajdów na Linuksie

Karina w ramach wolontariatu dla Mikropsów zgłasza się do robienia pokazów slajdów ukazujących metamorfozy podopiecznych fundacji. Opracowuje koncepcję, a trywialne zadanie jej zrealizowania zleca podwykonawcy w mojej osobie

Linuks nie słynie z programów do edycji filmów, ale do wykonania prostego pokazu zdjęć z muzyką nie trzeba wielkich kombajnów pokroju Adobe Premiere.

4K Slideshow Maker

Ta wieloplatformowa aplikacja pozwala przygotować pokaz slajdów bardzo szybko i bardzo łatwo. Tak naprawdę wystarczy tylko wybrać zdjęcia i muzykę, reszta robi się sama. Film taki jak poniżej można przygotować w 30 minut, łącznie z czasem generowania pliku:

Mikropsy 2018 from karniak on Vimeo.

Na powyższym filmie widać jednak niektóre ograniczenia programu:

  • Nie ma możliwości różnicowania poszczególnych slajdów, każdy musi trwać tyle samo i mieć zaaplikowany ten sam efekt.
  • Efektem przesunięcia i najazdu nie można w żaden sposób sterować, a program sam z siebie potrafi koncentrować się na na nieciekawych częściach zdjęcia.

OpenShot

To już nie jest prosty kreator, a pełnoprawna aplikacja do montażu wideo. Nie ma wad 4K Slideshow Makera, bo każdy slajd można wyklikać dokładnie wedle pragnienia, ale niestety wymaga to czasu. Pokazany poniżej film składałem jakieś trzy godziny, choć trochę czasu zajęła mi nauka programu.

Mikropsy 2019 1080p from karniak on Vimeo.

Do wad programu dodam jeszcze niezbyt wydajne działanie samego edytora nawet na relatywnie mocnym sprzęcie (Ryzen 1700, 16 GB RAM, SSD NVMe).

Hurtowe dodanie strict_types=1

Jednolinijkowiec na dziś:

grep -Z -r -L --include \*.php -P "strict_types=1" src/ | xargs -0 -l sed -i 's/<?php/<?php\n\ndeclare(strict_types=1);/g'

To polecenie wyszuka wszystkie pliki z rozszerzeniem php, które nie zawierają ciągu strict_types=1, a następnie doda declare(strict_types=1); zaraz po otwierającym znaczniku <?php. Żeby tylko wyszukać pliki, które nie mają strict_types=1 można użyć:

grep -r -L --include \*.php -P "strict_types=1" src/

Taki automat może się przydać przy modernizacji starszej aplikacji, warto jednak mieć dobre testy, bo taka trywialna zmiana może skutecznie ją wyłożyć.

UPSERT wielu wierszy w MySQL

Dzisiaj zacznę odwrotnie niż zwykle czyli od prezentacji gotowego rozwiązania:

INSERT INTO user_counters (user_id, counter_type, counter_value, updated_at)
VALUES
    (:user_id1, :counter_type1, :counter_value1, :updated_at1),
    (:user_id2, :counter_type2, :counter_value2, :updated_at2),
    # ...
    (:user_idN, :counter_typeN, :counter_valueN, :updated_atN)
ON DUPLICATE KEY UPDATE
    counter_value = counter_value + VALUES(counter_value),
    updated_at = VALUES(updated_at);

To tak zwany UPSERT czyli zapytanie, które wstawia rekord(y) do bazy, a jeśli taki już istnieje (tzn. istnieje już taki klucz główny lub unikalny) to go zaktualizuje (wartość w kolumnie counter_value zostanie powiększona o nową wartość, a w kolumnie updated_at zastąpiona). To zapytanie jest jednak trochę lepsze od tych, które zazwyczaj podaje się jako przykład UPSERTA, ponieważ pozwala zapisać wiele (dziesięć, sto, tysiąc) wierszy za jednym zamachem. Sprawia to użyta w części UPDATE funkcja VALUES(), która pobiera wartości ze wskazanej kolumny w części INSERT.

Po co się w ogóle tak babrać w SQL-u jak zwierzę skoro Doctrine mógłby to zrobić za nas? Akurat tego nie zrobi. Przy użyciu Doctrine należałoby:

  1. Pobrać wszystkie pasujące rekordy (jeden SELECT).
  2. Przeiterować przez nie i:
    • zaktualizować wartości,
    • zidentyfikować brakujące rekordy.
  3. Utworzyć encje brakujących rekordów.
  4. Opróżnić bufor managera encji (flush, który zapewne wykona jeden INSERT i jeden UPDATE).

Jak widać zarówno po stronie aplikacji (PHP) jak i bazy to wyraźnie więcej pracy, która i tak pewnie poszłaby na marne, bo przy kilku pracujących jednocześnie instancjach aplikacji jest spora szansa na wyjątek UniqueConstraintViolationException, który zamknie managera encji.

UPSERT z wieloma wartościami rozwiązuje problem wydajności i problem naruszania ograniczeń, ale tworzy klikna innych:

  • Przy jednoczesnych instancjach aplikacji łatwo o deadlocki na bazie. Trzeba zastosować jakiś mechanizm blokowania.
  • Jeśli w ten sposób zapisujemy dane z encji Doctrine’a to ich stan może być nieaktualny.

INSERT … ON DUPLICATE KEY UPDATE nie jest częścią standardu SQL, to rozszerzenie dostępne w MySQL. W PostgrSQL jest podobny mechanizm, ale jego działanie jest nieco inne, więc może opiszę je przy innej okazji.