microsoftgraph / microsoftgraph/msgraph-sdk-php
V2 pagination with getValue unclear
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- PHP
- Sterne
- 669
- Forks
- 150
- Ø Merge
- 15 Std. 21 Min.
- Gemergte PRs (30 T.)
- 3
Beschreibung
The documentation Get a collection of items mentions paging, but the example and code are not entirely clear here.
The call $messages->getValue() from the example would return a native php array type.
Is that array already filled with all items from all pages? Is that guaranteed? Or do I only get a single page here?
On a side note, it might have been better to return a \Generator that can be iterated over, independent on the page size, that will simply call the next page when it's its turn.
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Beginne mit dem Paging-Abschnitt in docs/Examples.md, insbesondere mit dem Beispiel „Get a collection of items“ und seinem Aufruf von $messages->getValue(). Verfolge das relevante Paging-Verhalten im SDK und dokumentiere anschließend, ob getValue() eine Seite oder alle Seiten enthält, und präzisiere das Beispiel; die angefragte Generator-Idee ist eine separate Überlegung.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- php
- Bereich
- documentation
- Issue-Typ
- Dokumentation
- Schwierigkeit
- 2/5
- Geschätzter Aufwand
- 1-3 Stunden
- Aktivitätsstatus
- Veraltet
- Klarheit
- Muss geklärt werden
- Anfängerfreundlichkeit
- 30/100