phpFashion

Na navigaci | Klávesové zkratky

Fight jazyků: co obnášejí dvě mutace Nette?

Stránky Nette existují ve dvou jazykových verzích: české a anglické. Udržovat tak obsáhlý projekt ve dvou mutacích vyžaduje dost práce, ale vidím v tom smysl.

Plnohodnotná česká dokumentace a fórum je totiž výhodou pro zdejší začínající programátory, protože žádný jiný framework ničím takovým nedisponuje. Samozřejmě ideální by bylo, kdyby každý Čech už od základní školy uměl plynně anglicky, ušetřilo by to hodně práce, ale není úkolem frameworku tohle suplovat. Nicméně angličtina není v žádném případě druhotným jazykem. Naopak. Posuďte sami:

Dokumentace. Její současná velikost čítá 3 MB textů (pro srovnání celé dílo Shakespeare má 5 MB). Anglická a česká jsou přitom zcela identické. Nejsem si vědom, že by jeden jediný odstavec existoval třeba v české verzi a anglické chyběl. Případně by se v jedné verzi objevil mnohem dříve než v druhé. Obě verze jsou neustále synchronizované. Pokud byste na nesoulad narazili, vytvořte prosím issue na GitHubu.

Anglické forum bylo spuštěno v roce 2008. Na českém až do minulého týdne svítila zpráva: „Chcete se zdokonalovat v angličtině? Zkuste psát do anglického fóra. I když by to bylo s chybami – těmi se člověk učí.“, takže i mnoho Čechů používá anglické fórum.

Nette Blog v tuto chvíli čítá 34 článků v angličtině a 19 v češtině. Rozhodně doporučuji blog sledovat, třeba přes RSS, stává se z něj hlavní zdroj informací o novinkách.

Diskuse na GitHubu jsou výhradně v angličtině. Tuším od roku 2012 je to oficiální podmínka. Jedinou výjimkou jsou diskuse o české dokumentaci, což je snad pochopitelné.

V celém kódu se nikdy neobjevilo jediné české slovo. Kód je od prapočátků pouze v angličtině, včetně všech chybových hlášek, komentářů atd. Tuším jen jednou se v něm vyskytlo slovo fuck 🙂

Dále je tu oficiální Twitter kanál, který je od počátku kompletně anglicky.

Co naopak anglicky není? Tak především jsou to videa z Posobot a facebooková stránka Nette Framework CZ/SK, která slouží zejména k informování o lokálních akcích, jako je právě Posobota nebo NettePivo. A taky kanál na Slacku Péhápkaři, což tedy není oficiální součást Nette.

Ještě pár technických záležitostí: pokud přijdete na úvodní stránku webu, fóra či blogu, nejspíš vás to přesměruje na českou verzi. Je to pouze proto, že máte v prohlížeči nastavený jako preferovaný jazyk češtinu nebo jste se už někdy v minulosti do české mutace přepnuli. Jinak samozřejmě přesměrovává na anglickou verzi.

Taktéž je určitý rozdíl mezi výpisem článků či příspěvků na českém a anglickém fóru. Web zkrátka předpokládá, že český uživatel anglicky číst umí, takže českým uživatelům se například u nejnovějších příspěvků vypisují i ty anglické nebo na českém blogu i anglické články, u který neexistuje českých překlad. Zahraniční uživatel tento mix nevidí.

Česká verze je zkrátka přidaným komfortem. Ale rozhodně preferujeme tvořit obsah v angličtině.

před 5 lety v rubrice PHP





Jak správně nastavit CSP a script-src

Content Security Policy (CSP) je dodatečný bezpečnostní prvek, který prohlížeči říká, jaké další zdroje může stránka načítat a jak může být zobrazena. Chrání tak před vkládáním škodlivého kódu a útokům jako je XSS. Odesílá se v podobě hlavičky sestavené z řady direktiv. Jeho nasazení ale není vůbec triviální.

Obvykle chceme používat JavaScriptové knihovny umístěné na různých místech mimo náš server, například měřící kód Google Analytics, reklamní systémy, captchy atd. A tady bohužel první verze CSP selhává. Vyžaduje přesnou analýzu načítaného obsahu a nastavení správných pravidel. Tedy vytvořit whitelist, výčet všech domén, což není snadné, jelikož některé skripty dynamicky dotahují další skripty z jiných domén, nebo jsou na jiné domény přesměrované atd. A i když si dáte práci a seznam vytvoříte ručně, nikdy nevíte, co se může v budoucnu změnit, takže musíte neustále sledovat, jestli je seznam stále aktuální a opravovat ho. Analýza Google ukázala, že i to pečlivé ladění ve finále vede k tomu, že povolíte tak široký přístup, že celý smysl CSP padá, jen posíláte s každým požadavek mnohem větší hlavičky.

CSP level 2 už k problému přistupuje jinak, pomocí nonce, nicméně teprve třetí verze řešení dotáhla do konce. Bohužel zatím (rok 2019) nemá dostatečnou podporu u prohlížečů.

O tom, jak sestavit direktivy script-src a style-src, aby správně fungovaly i ve starších prohlížečích a přitom s tím bylo co nejméně práce, jsem sepsal podrobný článek v partnerské sekci Nette. V zásadě výsledná podoba může vypadat nějak takto:

script-src 'nonce-XXXXX' 'strict-dynamic' * 'unsafe-inline'
style-src 'nonce-XXXXX' * 'unsafe-inline'

Příklad použití v PHP

Vygenerujeme nonce a odešleme hlavičku:

$nonce = base64_encode(random_bytes(16));

header("Content-Security-Policy: script-src 'nonce-$nonce' 'strict-dynamic' * 'unsafe-inline'");

A vložíme nonce do HTML kódu:

<script nonce="<?=$nonce?>" src="..."></script>

Příklad použití v Nette

Protože Nette má vestavěnou podporu pro CSP a nonce od verze 2.4, stačí v konfiguračním souboru uvést:

http:
	csp:
		script-src: [nonce, strict-dynamic, *, unsafe-inline]
		style-src: [nonce, *, unsafe-inline]

A v šablonách pak používat:

<script n:nonce src="..."></script>
<style n:nonce>...</style>

Monitoring

Než nastavíte nová pravidla pro CSP, vyzkoušejte si je nejprve nanečisto pomocí hlavičky Content-Security-Policy-Report-Only. Ta funguje ve všech prohlížečích podporujících CSP. Při porušení pravidel prohlížeč nezablokuje skript, ale jen pošle notifikaci na URL uvedené v direktivě report-uri. K příjmu notifikací a jejich analýze můžete použít třeba službu Report URI.

http:
	cspReportOnly:
		script-src: [nonce, strict-dynamic, *, unsafe-inline]
		report-uri: https://xxx.report-uri.com/r/d/csp/reportOnly

Můžete zároveň používat obě hlavičky a v Content-Security-Policy mít ověřené a aktivní pravidla a zároveň v Content-Security-Policy-Report-Only si testovat jejich úpravu. Samozřejmě i selhání ostrých pravidlech si můžete nechat monitorovat.

před 5 lety v rubrice PHP


Typed properties v PHP 7.4 jsou cool, ale ne jak si myslíte?

Po dvou verzích PHP, které nepřinesly nic moc zajímavého, se blíží verze, pro kterou bude mít opět smysl aktualizovat knihovny. Jde o PHP 7.4 a hlavním tahákem jsou typed properties, které uzavírají mnohaletý posun ke striktně typovanému jazyku, což PHP zvýhodňuje oproti jiným webovým jazykům.

Ve zkratce, tahle novinka vám umožní deklarovat typy přímo u proměnných třídy:

class Config
{
	public string $dsn;
	public ?string $user;
	public ?string $password;
	public bool $debugger = true;
}

Příklad použití najdete i v dokumentaci Nette Schema, které je na ně už dnes připravené.

Je potřeba říct, že pokud jste si navykli používat privátní proměnné a přistupovat k nim přes typehintované metody (což je správně), tak vlastně o žádnou killer feature nejde. Druhotná kontrola typů je zbytečná a vlastně jen zpomaluje kód. Diametrálně jiná situace se týká public/protected proměnných, kde dosud neexistoval žádný způsob, jak mít jejich hodnotu (a dokonce existenci) pod kontrolou. Až dosud.

Což nevyhnutelně povede k otázce:

Je nutné dál psát settery a gettery?

Sice veškerý boilerplate kód nám dnes na kliknutí generují editory, ale určitě vypadá hezky, když tohle:

class Circle
{
	private $radius;

	function setRadius(float $val)
	{
		$this->radius = $val;
	}

	function getRadius(): float
	{
		return $this->radius;
	}
}

nahradíte za:

class Circle
{
	public float $radius;
}

Nehledě na to, že i užití objektu je stručnější $circle->radius = $x vs $circle->setRadius($x).

Problém ale je, že velkou spoustu setterů a getterů nelze jednoduše nahradit. Třeba zrovna v uvedeném příkladu by se hodilo ještě ověřit, že poloměr není záporné číslo:

	function setRadius(float $val)
	{
		if ($val < 0) {
			throw new InvalidArgumentException;
		}
		$this->radius = $val;
	}

A v ten moment už nelze kód zredukovat do veřejné proměnné.

Jindy zase chceme, aby jednou nastavená hodnota byla neměnná, což nelze u public proměnné zajistit.

Nebo vůbec nechceme dávat k dispozici getter, protože nepatří do veřejného API třídy.

Anebo chceme mít setter či getter součástí rozhraní.

Atd, atd.

Zkrátka někdy bude možné použít typované veřejné proměnné místo metod, jindy ne, rozdíl bude dost často otázkou vnitřní implementace třídy a pro uživatele neprůhledný. Což je cesta v nekonzistentnímu API, kdy jednou se používá proměnná, jindy metoda a uživatel v tom nevidí logiku. (Podobně jako třeba metoda PDOStatement::errorInfo() vs. proměnná PDOException::$errorInfo).

Prohlubování nekonzistence ale nechceš. Raději konzistentní setrvání u metod, privátních proměnných a všeho toho boilerplate kódu. A pro privátní proměnné, jak jsem zmiňoval v úvodu, je přínos typehintů sporný. Nebo ne?

V čem je tedy výhoda?

Vlastně je výhod dost, i když v jiných oblastech. Typované proměnné budou užitečné pro kompilátor kvůli optimalizacím, pro práci s reflexí nebo nástroje analyzující kód. Důležité budou v šedé zóně protected proměnných. Umožňují zapsat prostředky jazyka to, co se dosud obcházelo komentářem. A navíc přinášejí do jazyka nový příznak neinicializovaného stavu, jakousi obdobu undefined z JavaScriptu.


Texy 3.0: do dokonalosti se nezasahuje

Něco jako když zahlédnete plakát ke koncertu kapely, kterou si vybavujete z mládí. Oni stále hrají? Nebo se dali dohromady po letech, protože potřebují peníze? Něco vyždímat na strunách nostalgie?

Texy je můj první open source projekt. Začal jsem ho psát před patnácti lety. Texy přežilo několik verzovacích systémů. Několik webových služeb hostujících repositáře. Několik kódování řetězců. Několik značkovacích jazyků pro tvorbu webových stránek. Několik mých životních vztahů. Několik měst, ve kterých jsem bydlel.

Texy je tady stále, protože neexistuje nic lepšího.

Takže jej patnáct let udržuji up-to-date. Začínali jsme v PHP 4, což byl ten nejhorší programovací jazyk na světě a tedy výzva, pak s úlevou přešli na PHP 5, o pár let později se ukryli do jmenného prostoru (Texy::Parser místo TexyParser, wow), sledovali, jak PHP přestávalo být nejhorším jazykem na světě, což otrávilo spoustu programátorů, kteří si našli náhradu v JavaScriptu, poté bůh stvořil PHP 7 a s ním typehinty (Texy::process(string $text): string megawow) a do módy přišla striktnost declare(strict_types=1) a tu my ctíme.

A proto je tu Texy 3.0.. Jde o úplně totéž, jako předchozí verze, ale má všechny vychytávky PHP 7.1. Je to úplně totéž proto, že do dokonalých věcí se nezasahuje.

Texy tu bylo, když jste se narodili. Programátorsky. Texy jednou bude formátovat váš epitaf. A mezi v a pokoji vloží nedělitelnou mezeru.



Co se chystá v Nette?

Co přinesou příští verze Nette Frameworku a jaký je plán pro další vývoj?

Nette je tvořeno řadou knihoven, z nichž některé patří mezi světovou špičku: Latte je nejbezpečnější šablonovací systém, Tracy je mnohými považován za nejpřívětivější debugovací nástroj, Dependency Injection Container patří mezi ty nejpohodlněji použitelné. Spousta konceptů vznikla šťastnou rukou a fungují v prakticky nezměněné podobě už 10 let, například formuláře nebo komponentový systém presenterů.

Nicméně ve všech oblastech je hodně příležitostí co vylepšovat a inovovat. A nápadů je spousta.

…pokračování


Nette spouští ambiciozní program

Nette spouští nový crowdfundingový program, jehož cílem je získat finanční prostředky pro vývoj frameworku. Hlavní změnou je, že místo jednorázových příspěvků je zaměřen na pravidelnou měsíční podporu. Ta může přicházet jak od jednotlivců, tak od firem, kterým nabízí možnost zviditelnit se na webu Nette a inzerovat na fóru nebo přímo v dokumentaci, tedy na místech s nejlepším zásahem cílové skupiny programátorů.

Každý, kdo staví na Nette, má zájem, aby se framework aktivně vyvíjel. Aby podporoval nové verze PHP. Aby se opravovaly chyby. Aby přicházel s dalšími novinkami, které usnadní práci nebo ušetří čas a peníze. Aby framework měl skvělou dokumentaci a existoval kolem něj užitečný obsah, ať už ve formě článků, návodů nebo videí.

Řada částí Nette představuje světovou špičku a chceme, aby tomu tak bylo nadále.

Bez adekvátního financování se nic z toho nedá zajistit. Přitom abyste se mohli spolehnout, že vyjdou další verze, stačí docela málo: abyste jej každý měsíc podpořili byť jen malou finanční částkou.

Pojďte do toho a staňte se partnerem Nette!

Používá vaše firma Nette?

Pokud pracujete ve firmě, které Nette vydělává peníze, vysvětlete prosím svému šéfovi, že je dobrý nápad se stát partnerem a zajistit tak zdravé fungování projektu, na který spoléháte. Zvýšíte prioritu řešení vašich issues a zároveň zviditelníte svoji společnost v komunitě a přilákáte k sobě vývojáře.

Partnerství totiž přichází s exkluzivními výhodami. Například s uvedením vašeho loga na webu Nette, možností vkládat pracovní nabídky,
inzerovat na fóru (ukázka) nebo v dokumentaci (ukázka), tedy na místech se zcela nejlepším zásahem do skupiny Nette vývojářů.

Partnerům vystavujeme faktury, aby si mohli podporu dát do nákladů, a to buď měsíčně, čtvrtletně, půlročně nebo ročně.

Používáte Nette soukromě?

Stojíme také o vaši podporu. Přihlaste se k pravidelným donations přes PayPal. Vaše jméno bude vidět na webu Nette.

Kolik peněz je potřeba?

V tuto chvíli máme stanoveny tři cíle, kterých chceme dosáhnout.

Prvním cílem je 64.000 Kč měsíčně, které zajistí, že se vývoji bude věnovat jeden programátor na půl úvazku. Další vývoj Nette tak bude pokračovat, nicméně polovičním tempem než dosud, což není úplně ideální. Při dosažení hranice 128.000 Kč získá framework full-time vývojáře a nové verze mohou přicházet každý rok.

Náklady jsou tak nízké proto, že nepotřebujeme kanceláře a hlavně pracujeme na něčem, co nás baví.

Při dosažení třetí mety 196.000 Kč měsíčně budeme moci přizvat další spolupracovníky a vylepšovat tak web, dokumentaci, vytvářet nový obsah a nechat jej překládat do angličtiny. A tak oslovit zahraniční komunitu. Čtvrtá meta dává možnost zapojit druhého programátora, což by vývoj a správu issues značně zrychlilo.

Jakmile se dosáhne tohoto milníku, připravíme další cíle, které by počítaly s více programátory, mohly by vznikat nové užitečné nástroje a knihovny. Pak třeba vznikne i kniha o Nette.


Viz také Freelo.cz: 14 důvodů, proč podpořit Nette


phpFashion © 2004, 2024 David Grudl | o blogu

Ukázky zdrojových kódů smíte používat s uvedením autora a URL tohoto webu bez dalších omezení.