Halaman ini menjelaskan fungsi utilitas yang tersedia di EdgeScript, meliputi encoding dan decoding, pembuatan bilangan acak, checksum, konversi tipe, dan pembuatan unique identifier.
Encoding dan decoding Base64
EdgeScript menyediakan dua varian Base64: Base64 standar (base64_enc / base64_dec) dan Base64 aman URL (base64_enc_safe / base64_dec_safe). Gunakan varian standar untuk encoding umum, dan gunakan varian aman URL jika string hasil encode akan digunakan dalam URL atau HTTP header.
base64_enc
Melakukan encode pada string menggunakan encoding Base64 standar.
Sintaksis
base64_enc(s [, no_padding])Parameter
Parameter | Deskripsi |
| String yang akan di-encode. |
| Menentukan apakah karakter padding akan dihilangkan. Atur ke |
Nilai kembali
Mengembalikan string yang telah di-encode dengan Base64.
Contoh
if $http_data {
encdata = base64_enc($http_data)
say(concat('base64_encdata=', encdata))
}Request header: data: aGVsbG8sIGRzbA==
Output:
base64_decdata=hello, dsl
base64_encdata=aGVsbG8sIGRzbA==base64_dec
Melakukan decode pada string yang di-encode dengan Base64.
Sintaksis
base64_dec(s)Parameter
Parameter | Deskripsi |
| String yang di-encode dengan Base64 yang akan di-decode. |
Nilai kembali
Mengembalikan string mentah hasil decode.
Contoh
if $http_data {
decdata = base64_dec($http_data)
say(concat('base64_decdata=', decdata))
say(concat('base64_encdata=', base64_enc('hello, dsl')))
}Request header: data: aGVsbG8sIGRzbA==
Output:
base64_decdata=hello, dsl
base64_encdata=aGVsbG8sIGRzbA==base64_enc_safe
Melakukan encode pada string menggunakan encoding Base64 aman URL. Pada output, karakter + diganti dengan -, / diganti dengan _, dan karakter padding = dihapus.
Sintaksis
base64_enc_safe(str)Parameter
Parameter | Deskripsi |
| String yang akan di-encode. |
Nilai kembali
Mengembalikan string yang di-encode dengan Base64 aman URL.
Contoh
add_rsp_header('X-RESPOND-OUTPUT', concat('base64_enc_safe=', base64_enc_safe('hello, dsl')), true)Response header:
X-RESPOND-OUTPUT: base64_enc_safe=aGVsbG8sIGRzbAbase64_dec_safe
Melakukan decode pada string yang di-encode dengan Base64 aman URL. Sebelum proses decode, karakter - diganti dengan + dan _ diganti dengan /. Karakter padding (=) ditambahkan sesuai kebutuhan agar panjang string menjadi kelipatan empat.
Sintaksis
base64_dec_safe(str)Parameter
Parameter | Deskripsi |
| String yang di-encode dengan Base64 yang aman untuk URL yang akan di-decode. |
Nilai kembali
Mengembalikan string mentah hasil decode.
Contoh
add_rsp_header('X-RESPOND-OUTPUT', concat('base64_dec_safe=', base64_dec_safe(base64_enc_safe('hello, dsl'))), true)Response header:
X-RESPOND-OUTPUT: base64_dec_safe=hello, dslEncoding dan decoding URL
url_escape
Melakukan encode pada string menggunakan encoding URL (percent-encoding).
Sintaksis
url_escape(s)Parameter
Parameter | Deskripsi |
| String yang akan di-encode. |
Nilai kembali
Mengembalikan string yang telah di-encode dengan URL.
Contoh
raw = '/abc/123/ dd/file.m3u8'
esdata = url_escape(raw)
dsdata = url_unescape(esdata)
if eq(raw, dsdata) {
say(concat('raw=', raw))
say(concat('dsdata=', dsdata))
}Output:
raw=/abc/123/ dd/file.m3u8
esdata=%2Fabc%2F123%2F%20dd%2Ffile.m3u8
dsdata=/abc/123/ dd/file.m3u8url_unescape
Melakukan decode pada string yang di-encode dengan URL.
Sintaksis
url_unescape(s)Parameter
Parameter | Deskripsi |
| String yang di-encode dengan URL yang akan di-decode. |
Nilai kembali
Mengembalikan string mentah hasil decode.
Contoh
raw = '/abc/123/ dd/file.m3u8'
esdata = url_escape(raw)
dsdata = url_unescape(esdata)
if eq(raw, dsdata) {
say(concat('raw=', raw))
say(concat('dsdata=', dsdata))
}Output:
raw=/abc/123/ dd/file.m3u8
esdata=%2Fabc%2F123%2F%20dd%2Ffile.m3u8
dsdata=/abc/123/ dd/file.m3u8Pembuatan bilangan acak
randomseed
Menginisialisasi pembuat bilangan acak. Panggil fungsi ini sebelum rand untuk memastikan urutan bilangan acak yang berbeda pada setiap request.
Sintaksis
randomseed()Parameter
Tidak ada.
Nilai kembali
Tidak ada.
Contoh
randomseed()
r = rand(1, 100)rand
Mengembalikan bilangan acak dalam rentang yang ditentukan (inklusif).
Sintaksis
rand(n1, n2)Parameter
Parameter | Deskripsi |
| Batas bawah. |
| Batas atas. |
Nilai yang dikembalikan memenuhi kondisi n1 <= result <= n2.
Nilai kembali
Mengembalikan bilangan acak.
Contoh
r = rand(1, 100)rand_hit
Mengembalikan true atau false berdasarkan probabilitas yang ditentukan. Gunakan fungsi ini untuk menerapkan pemisahan traffic berbasis persentase atau peluncuran fitur bertahap.
Sintaksis
rand_hit(ratio)Parameter
Parameter | Deskripsi |
| Probabilitas untuk mengembalikan nilai |
Nilai kembali
Mengembalikan true atau false.
Contoh
rand_hit(80)rand_bytes
Membuat string numerik acak dengan panjang yang ditentukan.
Sintaksis
rand_bytes(len)Parameter
Parameter | Deskripsi |
| Panjang string numerik acak yang akan dibuat. |
Nilai kembali
Mengembalikan string numerik acak yang telah dibuat.
Contoh
rand_bytes(16)Checksum
crc
Menghitung nilai Cyclic Redundancy Check (CRC) untuk sebuah string.
Sintaksis
crc(s)Parameter
Parameter | Deskripsi |
| String yang akan dihitung nilai CRC-nya. |
Nilai kembali
Mengembalikan nilai CRC dari string input.
Contoh
crc('hello edgescript')Konversi tipe
tonumber
Mengonversi string menjadi tipe numerik.
Sintaksis
tonumber(s [, base])Parameter
Parameter | Deskripsi |
| String yang akan dikonversi. |
| Basis untuk konversi numerik. Nilai yang valid: |
Nilai kembali
Mengembalikan angka.
Contoh
n = tonumber('100')
say(concat('tonumber()=', n))Output:
tonumber()=100Unique identifier
uuid
Mengembalikan string UUID yang dibuat secara acak.
Sintaksis
uuid()Parameter
Tidak ada.
Nilai kembali
Mengembalikan string UUID. Contoh: 16903a86-4173-4dea-842c-926c5860fe05.
Contoh
say(uuid())Output:
16903a86-4173-4dea-842c-926c5860fe05