Tôi gần đây đã được truyền cảm hứng từ dự án Pyre của Nuno Maduro. Đây là một ứng dụng web cho phép bạn gửi các tin nhắn bí mật ngắn hạn đến bất kỳ ai bạn muốn. Các tin nhắn này được mã hóa khi lưu trữ, và chỉ bạn hoặc người có liên kết giải mã mới có thể đọc chúng.
Tôi muốn xây dựng một thứ tương tự với Upstash Redis, vì vậy tôi chọn một ngách: chia sẻ biến môi trường. Tôi đánh cược rằng tại một thời điểm nào đó, bạn đã phải chia sẻ bí mật với đồng nghiệp và tự hỏi làm thế nào để xây dựng một hệ thống cho phép làm điều đó một cách an toàn.
Giới thiệu Envflow, một dự án mẫu Laravel mà tôi đã xây dựng sử dụng Upstash Redis làm cơ sở dữ liệu chính để lưu trữ và chia sẻ dữ liệu được mã hóa.
Tôi sẽ đưa bạn qua quy trình xây dựng dự án này, từ đầu đến cuối, bỏ qua các chi tiết nhàm chán.
Technology Stack
Trước tiên, tôi đã chọn PHP và xây dựng dự án bằng stack TALL nổi tiếng:
- Tailwind CSS
- Alpine JS
- Laravel
- Livewire
- Upstash Redis
Cơ Sở Dữ Liệu
Tôi cần một nơi để lưu trữ dữ liệu được mã hóa có thể hết hạn sau một khoảng thời gian nhất định mà vẫn nhanh và tiết kiệm chi phí. Như bạn có thể đoán, tôi đã chọn Upstash Redis.
Upstash Redis là một cơ sở dữ liệu tương thích Redis không máy chủ (serverless) nên nó thực sự hoàn hảo cho trường hợp sử dụng này.
Psst… Chúng tôi có hướng dẫn Bắt đầu với Upstash Redis và Laravel!
Routes / Endpoints
Envflow chạy trên ba route chính, cộng với một route phụ giải thích dự án là gì. Những route này có thể được tìm thấy trong tệp routes/web.php.
Trang Chủ
Route trang chủ không chỉ đóng vai trò là trang đích cho dự án mà còn bao gồm một Form Livewire cho phép bạn mã hóa các biến môi trường. Trên trang này, bạn có thể đặt số lần biến môi trường có thể được giải mã và thời gian chúng sẽ hợp lệ.

Bạn có thể tìm thấy Component Trang Livewire tại app/Livewire/EncryptEnvPage.php và mẫu tương ứng tại resources/views/livewire/encrypt-env-page.blade.php.
Trang Thành Công
Trang thành công là một trang đơn giản hiển thị hai cách chia sẻ liên kết giải mã: một bao gồm khóa giải mã, trong khi cái khác tách khóa giải mã khỏi liên kết.

Bạn có thể tìm thấy Component Trang Livewire tại app/Livewire/SuccessPage.php và mẫu tương ứng tại resources/views/livewire/success-page.blade.php.
Trang Giải Mã
Đây là trang nơi phép màu giải mã xảy ra. Nhớ rằng chúng tôi không lưu trữ khóa mã hóa trong cơ sở dữ liệu Upstash Redis, chúng tôi chỉ lưu trữ giá trị được mã hóa – một đống ký tự vô nghĩa. Nhiệm vụ chính của trang Giải mã là lấy khóa giải mã và cố gắng giải mã các biến môi trường.

Bạn có thể tìm thấy Component Trang Livewire tại app/Livewire/DecryptEnvPage.php và mẫu tương ứng tại resources/views/livewire/decrypt-env-page.blade.php.
Actions (Hành Động)
Cho dự án này, tôi đã sử dụng mẫu Action/Executor để tổ chức các thành phần chính của logic nghiệp vụ trong ứng dụng của mình. Điều này cho phép khả năng tái sử dụng, kiểm thử và bảo trì trong tương lai khi mã phát triển, cũng như cho phép chia sẻ các hành vi này giữa các phần khác nhau của ứng dụng, ví dụ như một API tương lai... Ai biết chứ?...
Bạn có thể tìm thấy các Actions tại app/Actions nhưng tôi muốn giới thiệu cho bạn các Actions Mã hóa và Giải mã vì chúng là các thành phần chính xử lý mã hóa và giải mã các biến môi trường.
Mã Hóa
Tôi khá may mắn vì Laravel có sẵn trình trợ giúp Mã hóa (Encryption helper) nhưng tôi cần một cái khác một chút vì tôi muốn cung cấp một khóa mã hóa tùy chỉnh được tạo tại runtime.
Sau khi đào sâu, tôi tìm thấy cách! Chúng ta có thể sử dụng lớp cơ sở của Laravel Illuminate\Encryption\Encrypter.
use Illuminate\Encryption\Encrypter; $encrypter = new Encrypter( 'custom-encryption-key', // this is the one we would want to generate config('app.cipher'), // we'll use Laravel default cipher ); // Hooray! We can now encrypt our value $encryptedValue = $encrypter->encryptString($value);
Ổn rồi... Vậy là mã hóa đã hoạt động, nếu bạn đã kiểm tra các tệp tôi đã chia sẻ, bạn có thể nhận thấy mã này có thể được tìm thấy trong các Actions Mã hóa và Giải mã.
Lưu Trữ
Chúng ta đã nói về việc sử dụng Actions và lớp Encrypter gốc của Laravel để Mã hóa và Giải mã các giá trị, nhưng chúng ta chưa nói về cách lưu trữ chúng trong Upstash Redis.
Mã đó nằm trong Action StoreEnvFile.
Tôi muốn làm nổi bật một vài điều từ tệp đó, mã sau đây.
// ... RedisFacade::pipeline(function (Redis $pipe) use (...) { $options = ['EX' => $ttl]; // here is where we set the expiration time $pipe->set("envfile:$id", $encrypted->value, $options); $pipe->set("envfile:$id:shareLimit", $shareLimit, $options); }); // ...
Trong mã trên, bạn có thể thấy một pipeline Redis đang được sử dụng, điều này sẽ đảm bảo tất cả các lệnh được thực hiện trong một giao dịch duy nhất. Điều này quan trọng vì chúng ta không muốn lưu trữ giá trị được mã hóa nếu các lệnh set thất bại.
Triển Khai
Đối với việc triển khai, tôi đã sử dụng Laravel Cloud vừa được phát hành.
Triển khai lên Laravel Cloud cực kỳ dễ dàng, nó chỉ mất chưa đầy một phút để chuyển từ kho lưu trữ sang một ứng dụng đã được triển khai hoàn toàn với một instance Redis được gắn kèm và một tên miền đã được cung cấp. Ngay cả bây giờ, các lần triển khai chỉ mất chưa đầy 30 giây. 🚀

Bạn có thể truy cập môi trường sản xuất đã triển khai tại https://envflow.laravel.cloud.
Kết Luận
Tôi hy vọng bạn đã thích bài viết này và nó đã giúp bạn hiểu cách tôi xây dựng Envflow.
Tôi nghĩ rằng có rất nhiều ứng dụng có thể sử dụng Upstash Redis làm cơ sở dữ liệu chính, dù ở đây Redis được dùng như một kho khóa-giá trị (KV store), nó có thể làm nhiều hơn thế và tôi sẽ đảm bảo sẽ trình bày trong các bài viết tương lai với một dự án khác mà tôi sẽ làm việc.
Mã nguồn cho dự án này có sẵn trên GitHub, vui lòng kiểm tra và đóng góp nếu bạn có bất kỳ ý tưởng, gợi ý nào (hoặc tìm thấy bất kỳ lỗi nào).