Michael Tröger Nall-chan

Best Practice zur PHP-Modul Erstellung

Generelle Entwicklung
1. Module sollten grundsätzlich auf Englisch erstellt und ins Deutsche übersetzt werden
2. Fehlermeldungen dürfen mit @ nur verdeckt werden, wenn der Rückgabewert überprüft wird und bei einem echten Fehlerfall dies dem Nutzer mitgeteilt wird. Andernfalls findet man im Fehlerfall den Verursacher niemals heraus. Sichtbare Fehler können behoben werden. Unsichtbare Fehler bringen inkonsistentes Verhalten und frustrieren nur alle beteiligten.
3. Daten, welche der Benutzer nicht benötigt, sollten auch nicht in Variablen erscheinen (z.B. irgendwelche Puffer / Temporäre Inhalte in String Variablen). Dafür bietet das SDK die SetBuffer/GetBuffer Funktionen, welches über eine JSON Kodierung auch mehrere Elemente enthalten können.
Der Inhalt der library.json / module.json darf nur die von der Dokumentation definierten Felder enthalten. Andere Felder können in zukünftigen Version seitens IP-Symcon verwendet werden und sind vollständig r

	root@host:/# python3 tapo_scanner.py
	{
	"device_id": "36612bba[redacted]9005d5f",
	"owner": "E4483[redacted]BCBD1",
	"device_type": "SMART.TAPOPLUG",
	"device_model": "P110(EU)",
	"ip": "10.6.8.113",
	"mac": "28-87-BA-48-80-14",
	"is_support_iot_cloud": true,
	"obd_src": "tplink",

	http://miot-spec.org/miot-spec-v2/instances?status=all

	http://miot-spec.org/miot-spec-v2/instances?status=debug
	http://miot-spec.org/miot-spec-v2/instances?status=released

	and for example air purifier 3 cn (zhimi.airpurifier.ma4)

	https://miot-spec.org/miot-spec-v2/instance?type=urn:miot-spec-v2:device:air-purifier:0000A007:zhimi-ma4:1
	http://miot-spec.org/miot-spec-v2/instance?type=urn:miot-spec-v2:device:light:0000A001:philips-bulb:1
	http://miot-spec.org/miot-spec-v2/instance?type=urn:miot-spec-v2:device:fan:0000A005:zhimi-sa1:1