Inhaltsverzeichnis:
Dies ist ein Demoprojekt, um ein Beispiel für meine Fähigkeiten in der objektorientierten Programmierung mit PHP, dem Schreiben von PHPUnit-Einheitstests und der Nutzung von Tools wie Composer (einem Abhängigkeitsmanager für PHP), Git (einem verteilten Versionskontrollsystem) und dem zu geben Unix-Shell. Spiegelt auch mein Wissen über moderne Entwicklungsplattformen wie GitHub (ein Online-Quellcode-Repositories-Hub), Codecov (für Einblicke in die Codeabdeckung) und CircleCI (kontinuierliche Integration und kontinuierliche Bereitstellung) wider.
Dieses Projekt wurde auf keinen Fall für den Einsatz in der Produktion geschrieben, sondern kann unter Ihrer alleinigen Verantwortung beliebig genutzt werden. Sie können es auch teilen und als Grundlage für Ihr eigenes Projekt verwenden, wenn Sie es nützlich finden.
OoWordpressNonces ist ein Composer- Paket für WordPress zur Verarbeitung von WordPress-Nonces mithilfe eines objektorientierten Programmieransatzes .
Es ersetzt nicht das ursprüngliche WordPress Nonces-System, dieses Paket ist lediglich ein Wrapper, der einen OOP -Ansatz verwendet, für die ursprünglichen WordPress Nonces- Funktionen.
Der Code ist einfach, selbsterklärend und vollständig dokumentiert. In der Codequelle verfügt jede Klassenmethode über einen Link zur ursprünglichen WordPress-Funktion, die sie umschließt. Weitere Informationen finden Sie in der offiziellen WordPress-Dokumentation für Nonces
Sie können OoWordpressNonces installieren, indem Sie diese Paket-Repository-Spezifikation zur Datei composer.json
Ihres Projekts hinzufügen:
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/josepcrespo/oo-wordpress-nonces"
}
],
"require": {
"josepcrespo/oo-wordpress-nonces": "master"
}
}
und führen Sie dann php composer.phar update
aus.
In diesem Abschnitt erhalten Sie Anweisungen zum Einrichten dieses Projekts auf Ihrem lokalen Computer für Entwicklungs- und Testzwecke.
Klonen Sie das Projekt mit Git:
git clone https://github.com/josepcrespo/oo-wordpress-nonces.git
Oder laden Sie eine ZIP-Datei mit allen Projektdateien herunter: https://github.com/josepcrespo/oo-wordpress-nonces/archive/master.zip
Bevor Sie mit der Installation von Composer beginnen:
- Eine zwingende Voraussetzung ist die Installation von PHP auf Ihrem System. Wenn Ihre Entwicklungsumgebung unter macOS läuft, empfehle ich die Installation mit Homebrew
- Bevor Sie mit der Verwendung von Homebrew beginnen, wird dringend empfohlen, Xcode zu installieren und zu aktualisieren. Sie können Xcode über den macOS App Store installieren/aktualisieren.
- Wenn Sie macOS verwenden, müssen Sie auch die Xcode-Befehlszeilentools installieren. Um die Xcode-Befehlszeilentools zu installieren/aktualisieren, schreiben Sie diesen Befehl mit Terminal.app (nachdem Sie Xcode installiert oder aktualisiert haben):
xcode-select --install
Um Composer schnell im aktuellen Verzeichnis zu installieren, finden Sie aktualisierte Anweisungen auf der offiziellen Composer-Downloadseite.
Um die definierten Abhängigkeiten für Ihr Projekt zu installieren, führen Sie einfach den Composer- Installationsbefehl im Stammverzeichnis des Projekts aus, indem Sie Terminal.app (wenn Sie macOS verwenden) oder Ihre bevorzugte Shell verwenden:
php composer.phar install
Weitere Informationen finden Sie in den offiziellen Composer-Richtlinien zum Installieren von Abhängigkeiten.
Wenn Sie bei der Composer -Installation die Option --filename
verwendet haben
- Möglicherweise haben Sie Ihren Composer mit der Installer-Option
--filename
installiert, zum Beispiel auf diese Weise:php composer-setup.php --filename=composer
In diesem Fall sollten Siecomposer install
ausführen, um die Abhängigkeiten zu installieren.
Die Unitary-Tests dieses Pakets wurden mit PHPUnit durchgeführt.
cp phpunit.xml.dist phpunit.xml
vendor/bin/phpunit
Nachdem Sie die Tests ausgeführt haben, können Sie die Ergebnisse der Testabdeckung anzeigen, indem Sie die Datei index.html
öffnen, die im Ordner tests/code-coverage-reports/html-format/
erstellt wurde.
Wenn PHPUnit eine Fehlermeldung ausgibt, dass es eine in den Tests verwendete Klasse nicht finden kann.
- Verwenden Sie den folgenden Composer -Befehl und führen Sie dann die Tests erneut aus.
php composer.phar dump-autoload
Sie müssen die Xdebug-PHP-Erweiterung aktivieren.
- Die Code-Coverage-Funktionalität von PHPUnit ist standardmäßig für dieses Projekt konfiguriert. Es nutzt die PHP_CodeCoverage- Komponente, die wiederum die Code-Coverage-Funktionalität nutzt, die von der Xdebug-Erweiterung für PHP bereitgestellt wird.
- Wenn Sie keine Codeabdeckung sehen möchten oder die Xdebug-Erweiterung nicht ordnungsgemäß aktivieren können, können Sie den vollständigen
-Eintrag in der Konfigurationsdatei phpunit.xml entfernen.