连接到Solana环境

当你进行Solana开发时，你需要连接到特定的RPC API端点。Solana有3个公共开发环境：

主网beta(mainnet-beta)：https://api.mainnet-beta.solana.com
开发网(devnet)：https://api.devnet.solana.com
测试网(testnet)：https://api.testnet.solana.com

使用网络昵称进行连接

使用昵称或名称连接到Solana公共RPC端点：

/* TS使用grill库 */
import { createSolanaClient } from "gill";

const { rpc, rpcSubscriptions } = createSolanaClient({
  urlOrMoniker: "devnet", // or `mainnet`, `localnet`, etc
});

/* TS使用web3.js库 */
import { clusterApiUrl, Connection } from "@solana/web3.js";

const connection = new Connection(clusterApiUrl("mainnet-beta"), "confirmed");

使用特定RPC URL进行连接

要连接到特定RPC API端点：本地测试网验证器或远程RPC提供程序，请使用以下命令：

/* TS使用grill库 */
import { createSolanaRpc, createSolanaRpcSubscriptions, devnet } from "gill";

const rpc = createSolanaRpc(devnet("https://api.devnet.solana.com"));

const rpcSubscriptions = createSolanaRpcSubscriptions(
  devnet("wss://api.devnet.solana.com"),
);

/* TS使用web3.js库 */
import { Connection } from "@solana/web3.js";

// 以下一行代码将连接到本地测试网验证器
const connection = new Connection("http://127.0.0.1:8899", "confirmed");

参考

Connecting to a Solana Environment

01/03/2025

如何启动一个Solana本地验证者节点(Local Validator)

在本地测试你的程序代码比在devnet上测试更可靠，并且可以帮助你在devnet上试用之前进行测试。

你可以通过安装Solana CLI工具套件并运行以下命令来设置本地测试验证器：

solana-test-validator

使用本地测试节点的好处包括：

无RPC速率限制
无空投数量限制
直接链上程序部署 (–bpf-program …)
从公共集群克隆帐户，包括程序 (–clone …)
可配置的交易历史保留 (–limit-ledger-size …)
可配置的epoch长度 (–slots-per-epoch …)
跳转到任意一个slot (–warp-slot …)

常见问题及解决方法

启动solana-test-validator报错Aborted (core dumped)

$ solana-test-validator
Aborted (core dumped)

你可以使用--log选项查看具体错误信息：

$ solana-test-validator --log
[2025-02-28T08:47:17.500858651Z INFO  solana_test_validator] agave-validator 2.1.14 (src:3ad46824; feat:3271415109, client:Agave)
[2025-02-28T08:47:17.500903233Z INFO  solana_test_validator] Starting validator with: ArgsOs {
        inner: [
            "solana-test-validator",
            "--log",
        ],
    }
[2025-02-28T08:47:17.500940423Z WARN  solana_perf] CUDA is disabled
[2025-02-28T08:47:17.500970698Z INFO  solana_perf] AVX detected
[2025-02-28T08:47:17.500975929Z ERROR solana_perf] Incompatible CPU detected: missing AVX2 support. Please build from source on the target
Aborted (core dumped)

以上报错表明你的CPU不支持AVX2指令集。运行以下命令，如果没有任何输出就表明你的CPU不支持AVX2指令集：

$ grep avx2 /proc/cpuinfo

AVX2（Advanced Vector Extensions 2）是 Intel 和 AMD 的现代处理器中提供的一种 SIMD（Single Instruction, Multiple Data）指令集扩展。AVX2是AVX（Advanced Vector Extensions）指令集的后续版本，增加了更多的指令以提高数据并行性和处理效率。

主要特点：

SIMD计算：AVX2 提供对128位和256位宽度的SIMD指令支持，用于并行处理多个数据。
整数指令扩展：与AVX相比，AVX2不仅扩展了对浮点数运算的支持，还增强了对整数运算的支持，允许更高效的向量化处理。
增强的性能：AVX2在执行大规模数据计算时，特别是在进行矩阵运算、图形处理、加密、压缩算法等方面能显著提升性能。

哪些CPU支持AVX2：

Intel: 从**Haswell（第四代Core系列处理器）**开始，Intel处理器支持AVX2。
AMD: 从**Steamroller（Kaveri架构）**及后续处理器开始，AMD也开始支持AVX2。

因此，如果你的CPU是Intel Haswell架构及以后的系列，或者是AMD Kaveri架构及以后的系列，那么它就支持AVX2指令集。

如果你的CPU不支持AVX2指令集，那么方法一是下载Solana源码自己构建，方法二是使用Docker运行非AVX版本的Solana。

方法一，下载Solana源码自己构建

步骤如下：

1 先更新一下系统的软件包

对于Ubuntu：

$ sudo apt-get update

2 安装依赖项

$ sudo apt-get install libssl-dev libudev-dev pkg-config zlib1g-dev llvm clang make

3 安装Rust

$ curl https://sh.rustup.rs -sSf | sh
$ source $HOME/.cargo/env
$ rustup component add rustfmt

4 下载Solana源码

$ mkdir ~/solana && cd ~/solana
$ git clone https://github.com/solana-labs/solana.git

5 构建

$ cd solana

切换到稳定版本分支：

$ git checkout v1.18.26

执行构建：

$ cargo clean
$ export RUST_REED_SOLOMON_ERASURE_ARCH=native
$ export RUSTFLAGS="-C target-feature=-avx2"
$ ./scripts/cargo-install-all.sh .

6 运行solana-test-validator

我们是从克隆Solana的git存储库构建得到二进制文件，就不需要先执行solana-install init命令了，直接执行solana-test-validator启动一个本地验证者节点：

$ ./target/release/solana-test-validator

如果输出如下信息：

Ledger location: test-ledger
Log: test-ledger/validator.log
⠤ Initializing...                                                                                                                                                                                               Waiting for fees to stabilize 1...
Identity: H4gRUMNMJfd8fsVDhnvmnt4SenqELPdtUAEuGFLBFj5c
Genesis Hash: 4NHw8wya1tD2eFbLPpRwtVeAKBAKSd8EiARk8h3u3QGj
Version: 1.18.26
Shred Version: 47462
Gossip Address: 127.0.0.1:1024
TPU Address: 127.0.0.1:1027
JSON RPC URL: http://127.0.0.1:8899
WebSocket PubSub URL: ws://127.0.0.1:8900

表示本地测试网启动成功！

通过上述步骤构建得到的Solana的可执行的二进制文件在~/solana/solana/target/release/和~/solana/solana/bin/里。可以把以下这行代码写入家目录里的.profile文件里，就可以直接使用可执行的二进制文件的名字来运行它了：

export PATH="~/solana/solana/bin:$PATH"

使.profile文件的修改生效：

$ source ~/.profile

7 创建一个Solana账户

执行以下命令创建一个Solana账户：

$ solana-keygen new

要记住生成的Solana账户的种子和公钥。

8 在本地测试网申请空投（水龙头币）

连接到本地测试网：

$ solana config set --url http://localhost:8899

在本地测试网请求空投：

$ solana airdrop 1

返回如下结果：

Requesting airdrop of 1 SOL

Signature: 5a6YXCwMVgwmxBz7p4g2LnTuhK2hVKqGW9QfUguJmruxLDvWKwq1xx1W2XuUiAJuqLmxEtPUAgQcri5RRjjouNQP

500000001 SOL

可以看到我们的账号里有500000001个SOL。因为默认情况下，本地测试网会向你的本地钱包账户（~/.config/solana/id.json）空投50000000个SOL，以便你能够进行测试、部署智能合约和交易。可以使用以下命令查询本地钱包账户的余额：

$ solana balance
500000001 SOL

也可以通过RPC接口查询账户的余额：

curl --location --request POST 'http://localhost:8899' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBalance",
    "params": [
        "AoKpX1XF22sJWpuv2gE36YEYekQV5EeQghyPSnYvLTkv"
    ]
}'

其中

http://localhost:8899是本地测试网的网址
AoKpX1XF22sJWpuv2gE36YEYekQV5EeQghyPSnYvLTkv是账户的公钥，也是账户的地址

返回如下结果：

{"jsonrpc":"2.0","result":{"context":{"apiVersion":"1.18.26","slot":4506},"value":500000001000000000},"id":1}

可以看到余额是500000001000000000，因为SOL的精度是10^9，所以也就是500000001个SOL。

方法二，使用Docker运行非AVX版本的Solana

我暂时没有在dockerhub网站找到非AVX版本的Solana镜像。

参考

How to Start a Local Validator

https://solana.stackexchange.com/questions/4703/how-to-fix-solana-test-validator-illegal-instruction-core-dumped-error-even-af

https://github.com/solana-labs/solana/issues/21233

https://stackoverflow.com/questions/71770717/anchor-test-without-avx2-cpu

28/02/202506/03/2025

基于CSS网格布局的全屏布局实现

本文翻译自《Full-Bleed Layout Using CSS Grid》。

过去，每个人都力图创建一种黄金标准的网站布局：圣杯布局。但众所周知，这种布局很难做到正确。

这看起来似乎不是那么棘手，对吧？但那是flex布局出现之前的时代；我们用于这项工作的工具是表格和浮动布局，但两者都不能真正胜任这项任务。这在技术上是可行的，但需要一些额外技巧。

一旦flex获得主流浏览器支持，这种布局就从“圣杯”变成了“喷泉饮料”；它无处不在，因为它提供了出色的用户体验，并且所有开发人员都可以使用。

随着网络的发展，我发现了一种新的理想的布局。它提供了极好的用户体验，尤其是对于新闻文章或文档等长篇文本内容。但是，就像它的前辈一样，它很难实现；大多数实现都需要晦涩难懂的黑客手段或违反直觉的技巧。

我最近发现了一个使用CSS Grid的优雅解决方案。在这篇文章中，我们将了解它的工作原理！

问题所在

你曾经尝试过在超大屏幕上阅读维基百科吗？它看起来像这样：

这些段落太宽了！维基百科根本不限制容器的宽度。这导致一行的长度有数百个字符。

当我们到达一行的末尾时，我们的眼睛很难回过头来。如果你像我一样，你最终会使用鼠标来辅助：

除了换行问题之外，太宽的文本行通常也难以阅读；它会使眼睛疲劳。

研究表明理想的行长约为65个字符。在罗马字母的背景下，45到85之间的任何字符通常都被认为是可以接受的。阅读是一个复杂的过程，我们应该努力让它尽可能简单。

此问题的标准解决方案是在页面中心创建一个固定宽度的列。你到处都见过这种布局：在线杂志、文档、新闻网站和博客。你现在正在当前网站上看到它！

然而，还有一个复杂的因素——并非所有内容都应受到限制。我们应该允许图像、视频和自定义小部件的宽度可自由调节：

这种事情的常用术语是“全出血(full-bleed)”。这是从出版界借用的术语；当某些东西以全出血方式打印时，它会延伸到纸张的最边缘。

这项新要求使问题变得更加棘手。限制所有子元素相对容易，但CSS实际上没有选择性地限制某些子元素的机制。

解决方案

让我们从最后开始，看看我们的解决方案：

.wrapper {
  display: grid;
  grid-template-columns:
    1fr
    min(65ch, 100%)
    1fr;
}

.wrapper > * {
  grid-column: 2;
}

.full-bleed {
  width: 100%;
  grid-column: 1 / 4;
}

这些样式应用于以下HTML：

<main class="wrapper">
  <h1>Some Heading</h1>
  <p>Some content and stuff</p>
  <img class="full-bleed" alt="cute meerkat" src="/meerkat.jpg" />
</main>

让我们一步步解释以上样式。

网格

.wrapper {
  display: grid;
  grid-template-columns:
    1fr
    min(65ch, 100%)
    1fr;
}

如果你不熟悉CSS Grid布局，这可能看起来像是很多随机字符和关键字。不要害怕！一切都会解释清楚。

grid-template-columns是一种属性，可让我们定义网格的形状。通过提供3个离散的属性值，我们表示我们想要3列。

这些值定义每列的宽度。第一列是1fr，与最后一列相同。fr单位是一个可填充可用空间的灵活单位。它在原理上类似于flex-grow；它是列应占用多少可用空间的比率。

我们的中心列是固定宽度的。我们使用min助手函数来选择最终较小的值。在大屏幕上，它将占用65ch宽度。在较小的屏幕上，如果没有足够的水平空间容纳65个字符，它将被限制为可用容器宽度的100%。

（如果你使用Sass，min关键字将无法正常工作，因为它已经是Sass预处理器中的辅助程序。查看解决方法。）

实际上，上述HTML代码在浏览器中看起来是这样的：

它很有特色

正如我们讨论过的，我们希望限制文本的长度，以便每行大约有65个字符宽。我们可以使用像素“估计”宽度，但CSS有一个模糊的单位可以让我们的生活更轻松一些：ch

.wrapper {
  /* 估计的宽度 */
  width: 800px;

  /* 理想的宽度 */
  width: 65ch;
}

ch是一个单位，就像px或rem。它对应于当前字体中0字符的宽度，适用于指定的字体大小。我们不是通过逆向工程获得像素宽度，而是以字符为单位指定宽度。

实际上，你可能仍需要进行一些调整；例如，如果你的字体中0字符特别窄，则需要稍微调大一点一行的宽度。

分配子列

我们已经定义了一个3列网格，现在是时候为其分配子元素了。默认情况下，子元素将被插入到第一个可用的网格单元中。但我们想覆盖此默认行为；所有子元素都应位于中间列，而第一列和第三列则留空。

.wrapper > * {
  grid-column: 2;
}

在CSS Grid布局中，列索引从1开始，因此2是对中间列的引用。

星号(*)是通配符，将匹配所有类型的元素。我们说每个子元素都应分配给第二个列（即中间列）。每个新的子元素都会创建一个新行，如下所示：

通配符性能

你可能听说过使用通配符选择器(*)是一种不好的做法。有些人会告诉你它很慢，并且会影响页面的整体性能。

幸运的是，事实并非如此。2009年的一篇文章深入探讨了这个问题，即使在当时，当计算机速度较慢且浏览器优化程度较低时，这也不是问题。关于通配符选择器的性能问题是一个都市传说。

全出血子元素(Full Bleed Children)

24/02/2025

Laravel框架基于外键关系的级联删除的两种实现方法

例如一个论坛系统有帖子表topics和评论表replies。一个帖子可以有0条或多条评论。评论表replies有一个topic_id列，是指向帖子表topics的id列的外键。

当删除一个帖子时，应该级联删除其所有评论。有两种方法：

方法一，在评论表replies的迁移文件中，定义外键约束时调用onDelete('cascade')方法表示删除应级联：

$table->foreignId('topic_id')
      ->constrained()
      ->onDelete('cascade');

让Laravel框架帮我们做基于外键关系的级联删除操作。参考官方文档外键约束。这种方法简单有效，缺点是不够灵活，有些开发规范不推荐使用外键约束。

方法二，在Eloquent模型的deleted事件的监听器中自己写代码实现级联删除，好处是灵活、扩展性强，不受底层数据库约束，坏处是要自己写很多代码，容易产生bug。

在实际开发中，方法二用得更多，因为更灵活、扩展性强。例如可以方便实现“不真正删除而是放入回收站表”这种功能。

参考

9.3. 防止数据损坏

22/02/2025

Laravel Eloquent模型类使用selectRaw或DB::raw方法执行聚合查询会报错MissingAttributeException

我的Laravel版本是11。我执行以下代码能正常获得查询结果：

$topic_users = DB::table('topics')->select(DB::raw('user_id, count(*) as topic_count'))->where('created_at', '>=', Carbon::now()->subDays(60))->groupBy('user_id')->get();

或

$topic_users = DB::table('topics')->selectRaw('user_id, count(*) as topic_count')->where('created_at', '>=', Carbon::now()->subDays(60))->groupBy('user_id')->get();

但执行以下代码：

$topic_users = Topic::select(DB::raw('user_id, count(*) as topic_count'))->where('created_at', '>=', Carbon::now()->subDays(60))->groupBy('user_id')->get();

或

$topic_users = Topic::query()->select(DB::raw('user_id, count(*) as topic_count'))->where('created_at', '>=', Carbon::now()->subDays(60))->groupBy('user_id')->get();

或

$topic_users = Topic::selectRaw('user_id, count(*) as topic_count')->where('created_at', '>=', Carbon::now()->subDays(60))->groupBy('user_id')->get();

报错：

Illuminate\Database\Eloquent\MissingAttributeException  The attribute [view_count] either does not exist or was not retrieved for model [App\Models\Topic].

该错误的原因是在使用Topic模型执行查询时，Laravel Eloquent默认会尝试加载模型中声明的所有属性（即数据库表中的所有列），但是你的查询语句是聚合查询，只返回user_id和聚合字段topic_count。Laravel Eloquent默认会尝试加载Topic模型中的所有字段，期望你返回的是一个“普通”的字段列表，而不是聚合后的结果，因此出现了MissingAttributeException错误，因为在查询结果中并没有view_count字段。

17/02/2025

配置Nginx禁止外网访问网站里的某个文件的方法

server {
    ...
    location = /test/test.ini {
        deny all;
    }
    ...
}

其中

location = /test/test.ini：这个配置会匹配精确的 URL 路径 /test/test.ini。
deny all：这条指令禁止所有的访问，任何请求访问该文件都会收到 403 Forbidden 错误。

完成配置后，重新加载 Nginx 配置：

sudo nginx -s reload

14/02/2025

在实际的网页开发中，nav是否应该作为header的子元素

header元素表示页眉，通常包含网站的标题、Logo、导航栏nav等内容。

nav元素表示导航栏，一般放在header元素或aside元素中，分别表示顶部导航栏或侧边导航栏，当然也可以视具体需求放在footer中表示底部导航栏。

13/02/2025

通过HTTPS访问网站，谷歌浏览器报错“使用了不受支持的协议ERR_SSL_VERSION_OR_CIPHER_MISMATCH”的原因及解决方法

我的软件环境：

Ubuntu 24

Nginx

Cloudflare DNS

我使用Let’s Encrypt的Cerbot为admin.larabbs.zuotijia.me申请SSL/TLS证书后，使用浏览器访问https://admin.larabbs.zuotijia.me网站报错：

谷歌浏览器报错“使用了不受支持的协议ERR_SSL_VERSION_OR_CIPHER_MISMATCH”的原因及解决方法。
火狐浏览器报错“连接到 admin.larabbs.zuotijia.me 时发生错误。无法安全地与对等端通信：没有双方共用的加密算法。错误代码：SSL_ERROR_NO_CYPHER_OVERLAP”

但是同样使用Let’s Encrypt的Cerbot为www.zuotijia.me申请SSL/TLS证书，能正常通过浏览器访问https://www.zuotijia.me网站。说明不是Cerbot的问题。

错误原因

错误原因是，在Cloudflare上使用的是Cloudflare免费提供的SSL通用证书(Cloudflare Universal SSL），它只支持根域名(yourwebsite.com)以及二级泛域名(*.yourwebsite.com)，不支持三级及以上的域名。

解决方法

方法一，不要使用三级及以上的域名。

方法二，在Cloudflare的仪表板->SSL/TLS->概述界面