Vegye figyelembe a következőket:
- A függvények egyenkénti telepítésére nem vonatkozik az 50-es korlát. Egyetlen kérés, amely a projekt összes függvényét lecseréli, továbbra is legfeljebb 50 függvényt tartalmazhat. A korlát a kérésben szereplő függvényeket számolja, nem a már telepítetteket.
- A backend-függvények maximális futási ideje 5 perc, amely ugyanúgy érvényes, akár közvetlenül hívják a függvényt, akár egy automatizálás indítja, akár munkafolyamat-lépésként fut. Az ezt túllépő kérések leállításra kerülnek. További információ a futtatási korlátokról.
Függvények létrehozása
A backend-függvényeket TypeScript-fájlokként hozza létre a projekt functions könyvtárában. Ez alapértelmezés szerint abase44/functions/ könyvtár, de az útvonalat a projektkonfigurációban módosíthatja.
Minden függvény saját alkönyvtárban található egy entry.ts vagy entry.js fájllal:
functions
<function-name>
entry.ts
functions/sendWelcomeEmail/entry.ts például egy sendWelcomeEmail nevű függvényt hoz létre. A rendszerezéshez alkönyvtárakba is ágyazhatja a függvényeket. A functions/email/send/entry.ts egy email/send nevű függvényt hoz létre.
Konfigurációs fájl hozzáadása
Haladó igényekhez, például egyéni függvénynevekhez adjon hozzá egyfunction.jsonc fájlt:
functions
<function-name>
entry.ts
function.jsonc
entry.ts
A kódfájl tartalmazza a függvény logikáját. A függvény kezel egy beérkező kérést, és egyResponse objektumot ad vissza. A kezelőt alapértelmezett exportként exportálja:
Több fájl egy függvényhez
Egy függvény nem korlátozódik egyetlenentry.ts fájlra. A logikát több fájlra bonthatja a függvény könyvtárán belül, és relatív útvonalakkal importálhatja őket. A függvény könyvtárában lévő minden .js, .ts, .json és .jsonc fájl a függvénnyel együtt telepítésre kerül.
functions
process-order
entry.ts
validate.ts
types.ts
Kód megosztása a függvények között
Ha kódot szeretne több függvényben újrahasználni, helyezze egyshared könyvtárba a base44/ mappán belül.
Egy függvény telepítésekor a CLI vele együtt feltölti a shared könyvtárat, a szerver pedig csak azokat a megosztott fájlokat csomagolja be, amelyeket az adott függvény importál. Minden függvény a saját másolatával települ az általa használt megosztott kódból. Ez a következőket jelenti:
- Bármely függvény importálhat a
sharedkönyvtárból relatív útvonallal. - Különböző függvények ugyanannak a megosztott fájlnak különböző verzióit futtathatják. Ha módosít egy megosztott fájlt, és csak egy függvényt telepít, csak annak a függvénynek a másolata frissül. A többiek megtartják a régi verziót, amíg újra nem telepíti őket. Ha egy megosztott módosítást mindenhol érvényesíteni szeretne, futtassa a
base44 functions deployparancsot argumentumok nélkül, hogy egyszerre újratelepítse az összes függvényt.
base44
shared
response.ts
functions
greet
entry.ts
farewell
entry.ts
Helyi tesztelés
Futtassa a függvényeket helyben abase44 dev paranccsal, hogy telepítés nélkül tesztelhesse a módosításokat. A részleteket a Helyi fejlesztés oldalon találja.
Függvények telepítése
A függvényeket afunctions deploy paranccsal telepítheti, vagy a deploy paranccsal egyszerre feltöltheti a projekt összes erőforrását. A functions deploy <names...> paranccsal név szerint telepíthet konkrét függvényeket, a --force kapcsolóval pedig eltávolíthatja a helyben nem található távoli függvényeket.
A telepített függvények helyi projektbe való letöltéséhez használja a functions pull parancsot. Hogy mi van jelenleg telepítve, a functions list paranccsal nézheti meg.
Függvények hívása
A backend-függvényeket a frontendből az SDK-val, webhookokhoz és külső integrációkhoz pedig HTTP-n keresztül hívhatja.Az SDK-val
Abase44.functions.invoke() metódussal hívhat függvényeket a frontendből. Az SDK automatikusan kezeli a hitelesítést, és átadja a függvénynek az aktuális felhasználó hitelesítő adatait.
HTTP-n keresztül
Minden telepített függvény HTTP-végpontot kap a következő címen:- Webhookok: Visszahívások fogadása külső szolgáltatásoktól, például a Stripe-tól vagy a GitHubtól.
- Külső integrációk: Más rendszerek kommunikálhatnak az alkalmazással.
- Tesztelés: Függvények közvetlen hívása olyan eszközökkel, mint a cURL vagy a Postman.
Közvetlen HTTP-hívás (például cURL vagy webhookok) esetén nincs
hitelesített felhasználói kontextus. Ilyenkor minden művelethez
használja az
asServiceRole lehetőséget.Függvénylánc-korlát
Az egymást hívó függvények lánca legfeljebb hét függvény hosszú lehet, a láncot indító függvényt is beleszámítva. A nyolcadik függvény minden Base44-hívása 403-as hibával,error code: 1000 kóddal meghiúsul. Ez az entitásokhoz és integrációkhoz intézett hívásokra is vonatkozik, és a láncon belüli újrapróbálkozás ugyanígy meghiúsul. Egy függvény akkor kerül a láncba, ha egy másik függvény a base44.functions.invoke() metódussal vagy az URL-jére irányuló fetch() hívással meghívja.
A korlát elkerülése:
- A több függvény által igényelt kódot helyezze a
base44/shared/könyvtárba, és importálja, ahelyett hogy egyik függvényt a másikból hívná. - Bontson egy hosszú feladatot külön lépésekre. Minden lépés mentse a haladását és térjen vissza, majd a következő lépést a frontendből vagy egy ütemezett munkafolyamatból indítsa, ne az előző lépésből.
Futtatási korlátok
Egy backend-függvény minden hívása a következő korlátokon belül fut. Ezek ugyanúgy érvényesek, akár közvetlenül hívják a függvényt, akár egy automatizálás indítja, akár munkafolyamat-lépésként fut.
Ha egy feladat túllépheti az 5 percet, bontsa lépésekre. Minden lépés mentse a haladását és térjen vissza. Ezután a következő lépést a frontendből vagy egy ütemezett automatizálásból indítsa.
Az SDK használata a függvényekben
A backend-függvényekben a Base44 SDK-n keresztül érheti el az alkalmazás adatait, hitelesítését és integrációit. AcreateClientFromRequest() segítségével hozzon létre klienst a beérkező kérésből.
A hitelesítési kontextus attól függ, hogyan hívták a függvényt:
-
Ha a frontendből az SDK-val hívták: A felhasználó hitelesítése automatikusan továbbítódik. Az aktuális felhasználót a
base44.auth.me()metódussal érheti el, és az ő jogosultságaival végezhet műveleteket. Ha az entitás-hozzáférési szabályok alkalmazása nélkül szeretne adatokat olvasni vagy írni, használja azasServiceRolelehetőséget. -
Ha közvetlen HTTP-n keresztül hívták (cURL, webhookok, külső szolgáltatások): Nincs hitelesített felhasználó, ezért minden művelethez az
asServiceRolelehetőséget használja.
Futtatókörnyezeti API
A Base44 beépítettbase44:runtime modult biztosít platformszintű segédeszközökkel a függvényekhez. Közvetlenül importálhatja, telepítés nélkül:
waitUntil(): életben tartja a függvényt, hogy a válasz visszaadása után befejezhesse a háttérmunkát.secrets: az alkalmazás titkos adatainak olvasása futásidőben asecrets.get()metódussal.
Háttérmunka futtatása a válasz után
AwaitUntil() segítségével életben tarthatja a függvényt a háttérmunkához a válasz visszaadása után. Adjon át neki egy promise-t, és a függvény addig fut, amíg az a promise le nem zárul. Így gyorsan válaszolhat, és utána fejezheti be az olyan munkákat, mint a naplózás, az értesítések vagy a kimenő webhookok.
waitUntil() ugyanazt a promise-t adja vissza, amelyet átad neki, így később ugyanabban a kezelőben összefűzheti vagy megvárhatja.
A háttérmunka a lehetőségekhez mérten fut. Nem garantált, hogy befejeződik vagy újrapróbálkozik, ezért
ne támaszkodjon rá olyan kritikus műveleteknél, amelyek nem veszhetnek el.
Titkos adatok olvasása
Asecrets.get() metódussal futásidőben olvashatja az alkalmazás környezeti változóit. Az értéket szövegként adja vissza, vagy undefined értéket, ha a titkos adat nincs beállítva:
secrets.get() metódust a kezelőn belül hívja, ne a modul legfelső szintjén. A titkos adatok kérésenként oldódnak fel, így a modul betöltésekor, bármely kérés futása előtt végzett olvasás undefined értéket ad vissza.
A titkos adatokat a CLI-ből a secrets set paranccsal konfigurálhatja.
Csatlakozás külső API-khoz
A backend-függvények a külső API-khoz való csatlakozás egyik módját jelentik. Ideálisak, ha teljes irányításra van szüksége a kérések felett, vagy az API-kulcsokat környezeti változóként szeretné biztonságosan tárolni. A környezeti változókat a CLI-ből asecrets set paranccsal konfigurálhatja.
Naplók megtekintése
Helyi fejlesztés közben a függvények kimenete közvetlenül a terminálban jelenik meg, alogs parancs nélkül.
A telepített függvények naplóit a logs paranccsal tekintheti meg. A naplók tartalmazzák a konzolkimenetet, a hibákat és az időzítési adatokat. Szűrhet függvénynév vagy időtartomány szerint. Ha MI-kódolóügynököt használ, a base44-troubleshooter skill automatikusan lekérheti és elemezheti ezeket a naplókat.
TypeScript-típusok
Generáljon TypeScript-típusokat a függvénykonfigurációkból, hogy típusbiztonságot és automatikus kiegészítést kapjon a függvénynevekhez az SDK-kódban. További információ a dinamikus típusokról.Lásd még
- Munkafolyamatok létrehozása: Függvények futtatása ütemezetten, vagy adat- vagy eszközváltozáskor
functionsmodul: SDK-referencia a függvények meghívásáhozcreateClientFromRequest: Kliens létrehozása backend-függvényekbenfunctions deploy: Helyi függvények telepítése a Base44-refunctions pull: Telepített függvények letöltése a helyi projektbefunctions list: Az összes telepített függvény listázásafunctions delete: Telepített függvények törléselogs: Függvénynaplók megtekintéseexec: Függvények elkülönített tesztelése önálló szkriptekből
Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az angol nyelvű változatot.