Hallo 1unitedpower,
2 dumme 1 gedanke :)
Ich würde aber tatsächlich das Array als 1. Parameter nehmen, weil die übrigen Array-Funktionen von PHP das auch so handhaben.
PHP ist da leider nicht konsistent, siehe z.B. array_map oder in_array. Aber ja, die Mehrheit der Funktionen scheint das Array als ersten Parameter entgegen zu nehmen.
Bei Nichtfinden eine Exception zu werfen ist eigentlich auch unerwartet - ich würde FALSE zurückgeben, das ist zwar konzeptionell idiotisch, aber idiomatisch für PHP (warum sind die beiden Worte nur so ähnlich).
Das überzeugt mich nicht. Silent Failures sind technische Schulden und verursachen reale Kosten. Die PHP Library ist historisch leider so gewachsen, aber das ist für mich noch kein Freifahrtsschein um den Fehler jetzt immer wieder neu zu begehen und de facto Geld zu verbrennen.