LaravelConf Taiwan 2018 - 跨境電商的眉眉角角 簡志豪 (Ronald) - Balivillas 合夥人 電商人人都在做，但當您面對的市場是跨國甚至是全球時，如何處理各國不同的時區、語系、幣別及金流？在今年的 LaravelConf Taiwan，議程組邀請到 Ronald 來為大家分享這些深藏在細節裡的魔鬼。

1. Balivillas 合夥⼈人
簡志豪 Ronald
跨境電商的眉眉⾓⾓

2. LaravelConf Taiwan 2018https://balivillas.com.tw 2
什什麼地⽅方不同
跨境電商的眉眉⾓角⾓角
!
跨境
Currency 幣別
Timezone 時區
Data Format 資料格式
Localization、Locale、Language

3. LaravelConf Taiwan 2018https://balivillas.com.tw 3
Localization、Locale、Language
"跨境電商的眉眉⾓角⾓角
Laravel 5
/config/app.php
隨時可以取得或改變 Locale
$locale = App::getLocale();
App::setLocale($locale);
Locale 的名稱需與 lang ⽬目錄的名稱相同
en => /resources/lang/en

4. LaravelConf Taiwan 2018https://balivillas.com.tw 4
Localization、Locale、Language
"跨境電商的眉眉⾓角⾓角
⼀一種 Locale 會對應⼀一個 lang ⽬目錄
Locale Lang ⽬目錄
zh-tw /resources/lang/zh-tw
en /resources/lang/en

5. LaravelConf Taiwan 2018https://balivillas.com.tw 5
Localization、Locale、Language
"跨境電商的眉眉⾓角⾓角
可以⼀一個 Locale 對應⼀一個 view ⽬目錄，或多個 Locale 對應⼀一個 view ⽬目錄
view 多
客製化、獨特性⾼高
建置維護成本⾼高
view 少
客製化、獨特性低
建置維護成本較低
Locale view ⽬目錄
zh-tw /resources/views/zh-tw zh-tw
zh-hk /resources/views/zh-hk zh-hk
en-us /resources/views/en
en
en-uk /resources/views/en
Locale view ⽬目錄
zh-tw
/resources/views
zh-hk
en-us
en-uk

6. LaravelConf Taiwan 2018https://balivillas.com.tw 6
探討⼀一下網址
#跨境電商的眉眉⾓角⾓角
網站如果只有⼀一種語⾔言
Locale 也只會有⼀一個
view ⽬目錄也只會有⼀一個
/resources/views
http://lctcbec.test/

7. LaravelConf Taiwan 2018https://balivillas.com.tw 7
探討⼀一下網址
#
http://lctcbec.test/
跨境電商的眉眉⾓角⾓角
不是個好⽅方法
每個語⾔言網址沒有特定的入⼝口
SEO問題
？？網址後綴區分？？

8. LaravelConf Taiwan 2018https://balivillas.com.tw 8
探討⼀一下網址
#跨境電商的眉眉⾓角⾓角
http://lctcbec.test/tw 台灣
http://lctcbec.test/hk 香港
http://lctcbec.test/sg 新加坡
http://lctcbec.test/jp ⽇日本
https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
每個 ISO_3166-1_alpha-2 國碼可對應⼀一個 Locale
(也可以多個國碼對應同⼀一個 Locale)
國碼 Locale lang ⽬目錄
tw zh-tw /resources/lang/zh-tw
hk zh-hk /resources/lang/zh-hk
sg en /resources/lang/en
jp jp /resources/lang/jp
en en /resources/lang/en
網址國碼 ≠ Locale
需額外將國碼對應⾄至 Locale

9. LaravelConf Taiwan 2018https://balivillas.com.tw 9
探討⼀一下網址
#跨境電商的眉眉⾓角⾓角
http://lctcbec.test/zh-tw 繁體中⽂文(台灣)
http://lctcbec.test/zh-hant 繁體中⽂文(台灣、香港、澳⾨門)
http://lctcbec.test/zh-hans 簡體中⽂文(中國、⾺馬來來⻄西亞)
http://lctcbec.test/zh-cn 簡體中⽂文(中國)
http://lctcbec.test/zh-hk 繁體中⽂文(香港)
https://zh.wikipedia.org/zh-tw/ISO_639-1
網址呈現語⾔言代碼 ＝ Locale

10. LaravelConf Taiwan 2018https://balivillas.com.tw 10
Timezone 時區
$跨境電商的眉眉⾓角⾓角
圖片來來源：
https://www.timeanddate.com/time/map/

11. LaravelConf Taiwan 2018https://balivillas.com.tw 11
Timezone 時區
$跨境電商的眉眉⾓角⾓角
Laravel 5
/config/app.php
合法 Timezone 設定值
http://php.net/manual/en/timezones.php

12. LaravelConf Taiwan 2018https://balivillas.com.tw 12
Timezone 時區
$跨境電商的眉眉⾓角⾓角
⼤大多跨境平台 Timezone 會設定為 UTC
例例外 => 如果跨境平台只集中在特定的 Timezone 地區
跨境平台只在華⼈人地區 (台灣、新加坡、⾺馬來來⻄西亞、中國、香港、澳⾨門等...)
這些地區的 Timezone 都是 UTC+8
設定 Timezone 為 UTC 只是⾃自找⿇麻煩

13. LaravelConf Taiwan 2018https://balivillas.com.tw 13
Timezone 時區
$跨境電商的眉眉⾓角⾓角
Timezone 設定 UTC 為例例
儲存入資料庫的⽇日期時間都必須是 UTC
儲存入資料庫的⽇日期時間都必須是 UTC
儲存入資料庫的⽇日期時間都必須是 UTC
不管在哪⼀一個時區獲得的時間資料 (Local time)
寫入資料庫前也都必須轉為 UTC 後寫入
很重要說三次

14. LaravelConf Taiwan 2018https://balivillas.com.tw 14
Timezone 時區
$跨境電商的眉眉⾓角⾓角
Timezone 設定 UTC 為例例
前端透過 API 帶時區參參數取得的 JSON
GET http://lctcbec.test/product/1?tz=Europe/London
前端透過 API 取得的 JSON
GET http://lctcbec.test/product/1
回傳時間均為 UTC 回傳時間均為 UTC+1 (Europe/London)
由前端將 UTC 轉為 Local time 由後端將 UTC 轉為 Local time

15. LaravelConf Taiwan 2018https://balivillas.com.tw 15
Timezone 時區
$跨境電商的眉眉⾓角⾓角
Timezone 設定 UTC 為例例
後端直接將資料 render 在 view 上
透過 session 裡的儲存、⽤用⼾戶的 ip、會員儲存偏好設定等等
取得時間要呈現的 Timezone
由後端將 UTC 轉為 Local time

16. LaravelConf Taiwan 2018https://balivillas.com.tw 16
Timezone 時區
$跨境電商的眉眉⾓角⾓角
Timezone 時區是會變的
⽇日光節約時間 Daylight saving time
北韓調整時區與南韓相同
許多國家有夏令⽇日光節約時間
台灣在⺠民國69年年前也有

17. LaravelConf Taiwan 2018https://balivillas.com.tw 17
Currency 幣別
◎跨境電商的眉眉⾓角⾓角
TWD
JPY
CNY
USD
EUR
問題1.
跨境平台上可交易易的幣別有什什麼？
問題2.
如果有多種可交易易的幣別
是否設定基底幣別？
問題2.1.
基底幣別是哪⼀一個？
問題3.
使⽤用固定匯率還是浮動匯率？

18. LaravelConf Taiwan 2018https://balivillas.com.tw 18
Currency 幣別
◎跨境電商的眉眉⾓角⾓角
跨境平台⼤大多使⽤用 美元 USD 做為基底幣別
美元
商品 $10 USD
NT$ 300 TWD (1 : 30)
€ 8 EUR (1 : 0.8)
$ USD
台幣
歐元
$
€
TWD
EUR
name code symbol exchange_rate active
美元 USD ＄ 1 TRUE
新臺幣 TWD NT＄ 30 TRUE
歐元 EUR € 0.8 TRUE
⼈人⺠民幣 CNY ¥ 6.5 FALSE
⾦金金額的呈現會⽤用基底幣別(USD)
對要呈現幣別的匯率來來做換算

19. LaravelConf Taiwan 2018https://balivillas.com.tw 19
Currency 幣別
◎跨境電商的眉眉⾓角⾓角
透過 session 裡的儲存、⽤用⼾戶的 IP 、會員儲存偏好設定等等
取得要呈現的幣別
但必須判斷此幣別是否 active
name code symbol exchange_rate active
美元 USD ＄ 1 TRUE
新臺幣 TWD NT＄ 30 TRUE
歐元 EUR € 0.8 TRUE
⼈人⺠民幣 CNY ¥ 6.5 FALSE
IP Currency USD Price active
荷蘭蘭 EUR $10 €8 TRUE
台灣 TWD $10 NT$30 TRUE
中國 CNY $10 $10 FALSE

20. LaravelConf Taiwan 2018https://balivillas.com.tw 20
所需套件
&跨境電商的眉眉⾓角⾓角
mcamara / laravel-localization
https://github.com/mcamara/laravel-localization
國際化與在地化 Locale
⼀一組網站上所⽀支援的 Locale 清單
如果 Locale 沒有呈現在網址上，
將會依照此 package 的設定取決於使⽤用 app.php 裡的 default locale
或是瀏覽器送的請求 header (Accept-Language)
⾃自動 301 轉址從沒有 locale 的網址⾄至包含有 locale 的網址
http://lctcbec.test/home http://lctcbec.test/zh-tw/home
⾃自動設定⽬目前 Locale 為 view-base-path zh-tw => /resources/lang/zh-tw/

21. LaravelConf Taiwan 2018https://balivillas.com.tw 21
所需套件
&跨境電商的眉眉⾓角⾓角
Torann / laravel-currency
https://github.com/Torann/laravel-currency
Currency 幣別、Exchange rates 匯率
可管理理⼀一組允許作為交易易的 Currency
⾦金金額⾃自動換算匯率後且呈現幣別特定的格式與貨幣符號
整合 https://openexchangerates.org/ 匯率取得服務
可切換 Currency

22. LaravelConf Taiwan 2018https://balivillas.com.tw 22
所需套件
&跨境電商的眉眉⾓角⾓角
Torann / laravel-geoip
https://github.com/Torann/laravel-geoip
根據 IP 判斷網站到訪者的地理理位置與相關資訊

23. LaravelConf Taiwan 2018https://balivillas.com.tw 23
!跨境電商的眉眉⾓角⾓角
建置
影片

24. LaravelConf Taiwan 2018https://balivillas.com.tw 24
Data Format 資料格式
跨境電商的眉眉⾓角⾓角
Propaganistas / Laravel-Phone
https://github.com/Propaganistas/Laravel-Phone
不同國家間電話號碼、⾏行行動電話號碼的格式化與驗證
commerceguys / addressing
https://github.com/commerceguys/addressing
glhd / laravel-addressing
https://github.com/glhd/laravel-addressing
不同國家間地址的格式化與驗證

25. LaravelConf Taiwan 2018https://balivillas.com.tw 25
!跨境電商的眉眉⾓角⾓角
建置
謝謝
sharenjoy / lctcbec
https://github.com/sharenjoy/lctcbec