Robert
1 month ago
parent
a9995970f3
commit
f89f6ae772
Binary file not shown.
@ -0,0 +1,3 @@ |
||||
About Data Transfer Objects, etc...: |
||||
|
||||
https://chatgpt.com/share/6956d98b-3d5c-8001-8139-a8598747b111 |
||||
@ -0,0 +1,62 @@ |
||||
<!DOCTYPE html> |
||||
<html lang="en"> |
||||
<head> |
||||
<meta charset="UTF-8"> |
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0"> |
||||
<title>Gang of Four Design Patterns</title> |
||||
</head> |
||||
<body> |
||||
<h1>23 Classic Gang of Four Design Patterns</h1> |
||||
|
||||
<p style="font-size: small;">Generated by ChatGPT:</p> |
||||
|
||||
<h2>Creational Patterns (deal with object creation)</h2> |
||||
<ol> |
||||
<li><strong>Singleton</strong> - Ensures a class has only one instance and provides a global point of access to it.</li> |
||||
<li><strong>Factory Method</strong> - Defines an interface for creating objects but lets subclasses decide which class to instantiate.</li> |
||||
<li><strong>Abstract Factory</strong> - Provides an interface for creating families of related objects without specifying their concrete classes.</li> |
||||
<li><strong>Builder</strong> - Separates the construction of a complex object from its representation, allowing the same construction process to create different representations.</li> |
||||
<li><strong>Prototype</strong> - Creates new objects by copying an existing object (prototype) rather than creating from scratch.</li> |
||||
</ol> |
||||
|
||||
<h2>Structural Patterns (deal with object composition)</h2> |
||||
<ol start="6"> |
||||
<li><strong>Adapter</strong> - Converts the interface of one class into another interface that clients expect, enabling incompatible classes to work together.</li> |
||||
<li><strong>Bridge</strong> - Decouples an abstraction from its implementation so they can vary independently, preventing a permanent binding between them.</li> |
||||
<li><strong>Composite</strong> - Composes objects into tree structures to represent part-whole hierarchies, letting clients treat individual objects and compositions uniformly.</li> |
||||
<li><strong>Decorator</strong> - Attaches additional responsibilities to an object dynamically, providing a flexible alternative to subclassing for extending functionality.</li> |
||||
<li><strong>Facade</strong> - Provides a unified, simplified interface to a complex subsystem, making it easier to use.</li> |
||||
<li><strong>Flyweight</strong> - Minimizes memory usage by sharing as much data as possible with similar objects; used when large numbers of objects are needed.</li> |
||||
<li><strong>Proxy</strong> - Provides a surrogate or placeholder for another object to control access to it, useful for lazy initialization, access control, or logging.</li> |
||||
</ol> |
||||
|
||||
<h2>Behavioral Patterns (deal with object interaction and responsibility)</h2> |
||||
<ol start="13"> |
||||
<li><strong>Chain of Responsibility</strong> - Passes a request along a chain of handlers, where each handler decides either to process the request or pass it to the next handler.</li> |
||||
<li><strong>Command</strong> - Encapsulates a request as an object, thereby allowing parameterization of clients with different requests and supporting undoable operations.</li> |
||||
<li><strong>Interpreter</strong> - Defines a grammatical representation for a language and an interpreter to evaluate sentences in that language.</li> |
||||
<li><strong>Iterator</strong> - Provides a way to access elements of an aggregate object sequentially without exposing its underlying representation.</li> |
||||
<li><strong>Mediator</strong> - Defines an object that encapsulates how a set of objects interact, promoting loose coupling by preventing objects from referring to each other explicitly.</li> |
||||
<li><strong>Memento</strong> - Captures and externalizes an object's internal state without violating encapsulation, so the object can be restored to this state later.</li> |
||||
<li><strong>Observer</strong> - Defines a one-to-many dependency between objects so that when one object changes state, all its dependents are notified and updated automatically.</li> |
||||
<li><strong>State</strong> - Allows an object to alter its behavior when its internal state changes, appearing to change its class.</li> |
||||
<li><strong>Strategy</strong> - Defines a family of algorithms, encapsulates each one, and makes them interchangeable, letting the algorithm vary independently from clients.</li> |
||||
<li><strong>Template Method</strong> - Defines the skeleton of an algorithm in a method, deferring some steps to subclasses, letting subclasses redefine certain steps without changing the algorithm's structure.</li> |
||||
<li><strong>Visitor</strong> - Represents an operation to be performed on elements of an object structure, letting you define new operations without changing the classes of the elements.</li> |
||||
</ol> |
||||
|
||||
<p>These patterns provide proven solutions to common software design problems, promoting code reuse, flexibility, and maintainability in object-oriented systems.</p> |
||||
|
||||
<h2>Links to more external resources not mine...</h2> |
||||
|
||||
<blockquote style="position: relative; font-style: italic; margin: 10px 0 0; padding: 10px 12px; border-left: 3px solid #60a5fa; border-radius: 10px;"> |
||||
<p>I'm not affiliated with nor profit from these Books, they are just here for your and my convenience.</p> |
||||
<p>Modern PHP 8 Design Patterns Online Version: <a href="https://designpatternsphp.readthedocs.io/en/latest/">https://designpatternsphp.readthedocs.io/en/latest/</a></p> |
||||
<p>PDF Version: <a href="https://designpatternsphp.readthedocs.io/_/downloads/en/latest/pdf/">https://designpatternsphp.readthedocs.io/_/downloads/en/latest/pdf/</a></p> |
||||
<p>Nice Book for sale: Buy Dive Into DESIGN PATTERNS An Ebook on design patterns and the principles behind them: <a href="https://refactoring.guru/design-patterns/book">https://refactoring.guru/design-patterns/book</a></p> |
||||
<p>PHP Code from the Book above: <a href="https://refactoring.guru/design-patterns/php">https://refactoring.guru/design-patterns/php</a>, If you liked it; Please support them by buying the book above...</p> |
||||
<p>"The Gang of 4 book" - Design Patterns: Elements of Reusable Object-Oriented Software By Erich Gamma, Richard Helm, Ralph Johnson, John Vlissides, Published Oct 31, 1994. Buy here it: <a href="https://www.informit.com/store/design-patterns-elements-of-reusable-object-oriented-9780201633610">https://www.informit.com/store/design-patterns-elements-of-reusable-object-oriented-9780201633610</a></p> |
||||
<p><a href="https://www.informit.com/imprint/series_detail.aspx?st=61147">More on The Addison-Wesley Professional Computing Series</a></p> |
||||
</blockquote> |
||||
</body> |
||||
</html> |
||||
@ -0,0 +1,154 @@ |
||||
<?php |
||||
declare(strict_types=1); |
||||
|
||||
namespace App\Log; |
||||
|
||||
use Psr\Log\LoggerInterface; |
||||
use Psr\Log\LogLevel; |
||||
use Psr\Log\InvalidArgumentException; |
||||
|
||||
final class Logger implements LoggerInterface |
||||
{ |
||||
private $handle = false; |
||||
|
||||
public function __construct( |
||||
string $filename = 'system', |
||||
int $maxCount = 1000 |
||||
) { |
||||
if (str_contains($filename, '..')) { |
||||
return; |
||||
} |
||||
|
||||
$logDir = BaseDir . '/protected/logs'; |
||||
|
||||
if (!is_dir($logDir)) { |
||||
mkdir($logDir, 0775, true); |
||||
} |
||||
|
||||
$filename = preg_replace('/[^A-Za-z0-9_]/', '', $filename); |
||||
$file = $logDir . '/' . $filename . '.log.txt'; |
||||
|
||||
if ($maxCount > 1 && $this->getLines($file) > $maxCount) { |
||||
@unlink($file); |
||||
} |
||||
|
||||
if (file_put_contents($file, "\n", FILE_APPEND) === false) { |
||||
return; |
||||
} |
||||
|
||||
@chmod($file, 0660); |
||||
@chgrp($file, 'www-data'); |
||||
|
||||
if (!is_writable($file)) { |
||||
return; |
||||
} |
||||
|
||||
$this->handle = fopen($file, 'ab'); |
||||
} |
||||
|
||||
/* ---------------- PSR-3 Core ---------------- */ |
||||
|
||||
public function log($level, $message, array $context = []): void |
||||
{ |
||||
if (!is_string($level)) { |
||||
throw new InvalidArgumentException('Log level must be a string'); |
||||
} |
||||
|
||||
if (!$this->handle || !is_resource($this->handle)) { |
||||
return; |
||||
} |
||||
|
||||
$message = $this->interpolate((string)$message, $context); |
||||
|
||||
$time = (new \DateTimeImmutable())->format('Y-m-d H:i:s'); |
||||
fwrite( |
||||
$this->handle, |
||||
sprintf("[%s] %s: %s\n", $time, strtoupper($level), $message) |
||||
); |
||||
} |
||||
|
||||
/* ---------------- Level Methods ---------------- */ |
||||
|
||||
public function emergency($message, array $context = []): void |
||||
{ |
||||
$this->log(LogLevel::EMERGENCY, $message, $context); |
||||
} |
||||
|
||||
public function alert($message, array $context = []): void |
||||
{ |
||||
$this->log(LogLevel::ALERT, $message, $context); |
||||
} |
||||
|
||||
public function critical($message, array $context = []): void |
||||
{ |
||||
$this->log(LogLevel::CRITICAL, $message, $context); |
||||
} |
||||
|
||||
public function error($message, array $context = []): void |
||||
{ |
||||
$this->log(LogLevel::ERROR, $message, $context); |
||||
} |
||||
|
||||
public function warning($message, array $context = []): void |
||||
{ |
||||
$this->log(LogLevel::WARNING, $message, $context); |
||||
} |
||||
|
||||
public function notice($message, array $context = []): void |
||||
{ |
||||
$this->log(LogLevel::NOTICE, $message, $context); |
||||
} |
||||
|
||||
public function info($message, array $context = []): void |
||||
{ |
||||
$this->log(LogLevel::INFO, $message, $context); |
||||
} |
||||
|
||||
public function debug($message, array $context = []): void |
||||
{ |
||||
$this->log(LogLevel::DEBUG, $message, $context); |
||||
} |
||||
|
||||
/* ---------------- Helpers ---------------- */ |
||||
|
||||
private function interpolate(string $message, array $context): string |
||||
{ |
||||
$replace = []; |
||||
|
||||
foreach ($context as $key => $value) { |
||||
if (is_scalar($value) || $value instanceof \Stringable) { |
||||
$replace['{' . $key . '}'] = (string)$value; |
||||
} |
||||
} |
||||
|
||||
return strtr($message, $replace); |
||||
} |
||||
|
||||
private function getLines(string $file): int |
||||
{ |
||||
if (!file_exists($file)) { |
||||
return 0; |
||||
} |
||||
|
||||
$lines = 0; |
||||
$fh = fopen($file, 'rb'); |
||||
|
||||
if (!$fh) { |
||||
return 0; |
||||
} |
||||
|
||||
while (!feof($fh)) { |
||||
$lines += substr_count(fread($fh, 8192), "\n"); |
||||
} |
||||
|
||||
fclose($fh); |
||||
return $lines; |
||||
} |
||||
|
||||
public function __destruct() |
||||
{ |
||||
if ($this->handle && is_resource($this->handle)) { |
||||
fclose($this->handle); |
||||
} |
||||
} |
||||
} |
||||
Loading…
Reference in new issue