← All changes | back/Libraries/Sabberworm/CSS/src/Settings.php +126 -0 10.10.1 → 11.1.0 View file →

		@@ -1,0 +1,126 @@
	1	+<?php
	2	+
	3	+declare(strict_types=1);
	4	+
	5	+namespace AcyMailing\Libraries\Sabberworm\CSS;
	6	+
	7	+/**
	8	+ * version 9.1.0
	9	+ *
	10	+ * Parser settings class.
	11	+ *
	12	+ * Configure parser behaviour here.
	13	+ */
	14	+class Settings
	15	+{
	16	+ /**
	17	+ * Multi-byte string support.
	18	+ *
	19	+ * If `true` (`mbstring` extension must be enabled), will use (slower) `mb_strlen`, `mb_convert_case`, `mb_substr`
	20	+ * and `mb_strpos` functions. Otherwise, the normal (ASCII-Only) functions will be used.
	21	+ *
	22	+ * @var bool
	23	+ */
	24	+ private $multibyteSupport;
	25	+
	26	+ /**
	27	+ * The default charset for the CSS if no `@charset` declaration is found. Defaults to utf-8.
	28	+ *
	29	+ * @var non-empty-string
	30	+ */
	31	+ private $defaultCharset = 'utf-8';
	32	+
	33	+ /**
	34	+ * Whether the parser silently ignore invalid rules instead of choking on them.
	35	+ *
	36	+ * @var bool
	37	+ */
	38	+ private $lenientParsing = true;
	39	+
	40	+ private function __construct()
	41	+ {
	42	+ $this->multibyteSupport = \extension_loaded('mbstring');
	43	+ }
	44	+
	45	+ public static function create(): self
	46	+ {
	47	+ return new Settings();
	48	+ }
	49	+
	50	+ /**
	51	+ * Enables/disables multi-byte string support.
	52	+ *
	53	+ * If `true` (`mbstring` extension must be enabled), will use (slower) `mb_strlen`, `mb_convert_case`, `mb_substr`
	54	+ * and `mb_strpos` functions. Otherwise, the normal (ASCII-Only) functions will be used.
	55	+ *
	56	+ * @return $this fluent interface
	57	+ */
	58	+ public function withMultibyteSupport(bool $multibyteSupport = true): self
	59	+ {
	60	+ $this->multibyteSupport = $multibyteSupport;
	61	+
	62	+ return $this;
	63	+ }
	64	+
	65	+ /**
	66	+ * Sets the charset to be used if the CSS does not contain an `@charset` declaration.
	67	+ *
	68	+ * @param non-empty-string $defaultCharset
	69	+ *
	70	+ * @return $this fluent interface
	71	+ */
	72	+ public function withDefaultCharset(string $defaultCharset): self
	73	+ {
	74	+ $this->defaultCharset = $defaultCharset;
	75	+
	76	+ return $this;
	77	+ }
	78	+
	79	+ /**
	80	+ * Configures whether the parser should silently ignore invalid rules.
	81	+ *
	82	+ * @return $this fluent interface
	83	+ */
	84	+ public function withLenientParsing(bool $usesLenientParsing = true): self
	85	+ {
	86	+ $this->lenientParsing = $usesLenientParsing;
	87	+
	88	+ return $this;
	89	+ }
	90	+
	91	+ /**
	92	+ * Configures the parser to choke on invalid rules.
	93	+ *
	94	+ * @return $this fluent interface
	95	+ */
	96	+ public function beStrict(): self
	97	+ {
	98	+ return $this->withLenientParsing(false);
	99	+ }
	100	+
	101	+ /**
	102	+ * @internal
	103	+ */
	104	+ public function hasMultibyteSupport(): bool
	105	+ {
	106	+ return $this->multibyteSupport;
	107	+ }
	108	+
	109	+ /**
	110	+ * @return non-empty-string
	111	+ *
	112	+ * @internal
	113	+ */
	114	+ public function getDefaultCharset(): string
	115	+ {
	116	+ return $this->defaultCharset;
	117	+ }
	118	+
	119	+ /**
	120	+ * @internal
	121	+ */
	122	+ public function usesLenientParsing(): bool
	123	+ {
	124	+ return $this->lenientParsing;
	125	+ }
	126	+}