安装与配置 #

# 检查Elixir版本
elixir -v

# 检查Erlang版本
erl -version

# 检查Hex包管理器
mix local.hex

# 检查PostgreSQL
psql --version

# 使用Homebrew安装
brew install elixir

# 或使用asdf版本管理器
brew install asdf

asdf plugin add erlang
asdf plugin add elixir

asdf install erlang 26.0
asdf install elixir 1.15.0

asdf global erlang 26.0
asdf global elixir 1.15.0

# Ubuntu/Debian
sudo apt update
sudo apt install erlang elixir

# 或使用asdf
git clone https://github.com/asdf-vm/asdf.git ~/.asdf
. $HOME/.asdf/asdf.sh

asdf plugin add erlang
asdf plugin add elixir
asdf install erlang 26.0
asdf install elixir 1.15.0

# 使用Chocolatey
choco install elixir

# 或下载安装包
# https://elixir-lang.org/install.html#windows

# 使用官方镜像
docker run -it elixir:1.15 bash

# 创建开发容器
FROM elixir:1.15

RUN mix local.hex --force && \
    mix local.rebar --force

WORKDIR /app

# 安装Hex包管理器
mix local.hex

# 安装Rebar构建工具
mix local.rebar

# 安装Phoenix项目生成器
mix archive.install hex phx_new

# 验证安装
mix phx.new --version

# PostgreSQL (推荐)
mix archive.install hex phx_new

# Phoenix默认使用PostgreSQL
# 确保PostgreSQL已安装并运行

# 使用Homebrew安装
brew install postgresql@15

# 启动服务
brew services start postgresql@15

# 创建数据库用户
createuser -s postgres

# Ubuntu/Debian
sudo apt install postgresql postgresql-contrib

# 启动服务
sudo systemctl start postgresql

# 创建用户
sudo -u postgres createuser -s $USER

# 运行PostgreSQL容器
docker run --name phoenix-db \
  -e POSTGRES_PASSWORD=postgres \
  -p 5432:5432 \
  -d postgres:15

# 连接信息
# host: localhost
# port: 5432
# user: postgres
# password: postgres

# 创建完整项目
mix phx.new my_app

# 进入项目目录
cd my_app

# 安装依赖
mix deps.get

# 不安装依赖（稍后手动安装）
mix phx.new my_app --no-deps

# 不包含数据库
mix phx.new my_app --no-ecto

# 不包含LiveView
mix phx.new my_app --no-live

# 使用MySQL
mix phx.new my_app --database mysql

# 使用SQLite
mix phx.new my_app --database sqlite3

# 使用Tailwind CSS
mix phx.new my_app --css tailwind

# API项目
mix phx.new my_api --no-html --no-assets

* creating my_app/config/config.exs
* creating my_app/config/dev.exs
* creating my_app/config/runtime.exs
* creating my_app/lib/my_app/application.ex
* creating my_app/lib/my_app.ex
* creating my_app/lib/my_app_web/controllers/page_controller.ex
* creating my_app/lib/my_app_web/endpoint.ex
...

Fetch and install dependencies? [Yn] Y
* running mix deps.get
* running mix assets.setup
* running mix assets.build

We are almost there! The following steps are missing:

    $ cd my_app

Configure your database in config/dev.exs and run:

    $ mix ecto.create

Start your Phoenix app with:

    $ mix phx.server

You can also run your app inside IEx (Interactive Elixir) as:

    $ iex -S mix phx.server

# config/dev.exs
import Config

config :my_app, MyApp.Repo,
  username: "postgres",
  password: "postgres",
  hostname: "localhost",
  database: "my_app_dev",
  stacktrace: true,
  show_sensitive_data_on_connection_error: true,
  pool_size: 10

# 创建开发数据库
mix ecto.create

# 输出
# The database for MyApp.Repo has been created

# config/dev.exs

# PostgreSQL配置
config :my_app, MyApp.Repo,
  username: "postgres",
  password: "postgres",
  hostname: "localhost",
  database: "my_app_dev",
  port: 5432,
  pool_size: 10

# MySQL配置
config :my_app, MyApp.Repo,
  username: "root",
  password: "",
  hostname: "localhost",
  database: "my_app_dev",
  port: 3306

# SQLite配置
config :my_app, MyApp.Repo,
  database: "path/to/database.db"

# 启动服务器
mix phx.server

# 输出
[info] Running MyAppWeb.Endpoint with cowboy 2.10.0 at 127.0.0.1:4000 (http)
[info] Access MyAppWeb.Endpoint at http://localhost:4000
[watch] build complete, watching for changes...

# 在IEx中启动
iex -S mix phx.server

# 可以在控制台执行代码
iex> MyApp.Accounts.list_users()

打开浏览器访问: http://localhost:4000
看到Phoenix欢迎页面表示安装成功

config/
├── config.exs      # 基础配置
├── dev.exs         # 开发环境配置
├── runtime.exs     # 运行时配置
├── test.exs        # 测试环境配置
└── prod.exs        # 生产环境配置（由runtime.exs替代）

# config/config.exs
import Config

config :my_app,
  ecto_repos: [MyApp.Repo]

config :my_app, MyApp.Repo,
  adapter: Ecto.Adapters.Postgres

config :my_app, MyAppWeb.Endpoint,
  url: [host: "localhost"],
  render_errors: [
    formats: [html: MyAppWeb.ErrorHTML, json: MyAppWeb.ErrorJSON],
    layout: false
  ],
  pubsub_server: MyApp.PubSub,
  live_view: [signing_salt: "your_signing_salt"]

config :logger, :console,
  format: "$time $metadata[$level] $message\n",
  metadata: [:request_id]

config :phoenix, :json_library, Jason

# config/dev.exs
import Config

config :my_app, MyAppWeb.Endpoint,
  http: [ip: {127, 0, 0, 1}, port: 4000],
  check_origin: false,
  code_reloader: true,
  debug_errors: true,
  secret_key_base: "your_secret_key_base"

config :my_app, MyApp.Repo,
  username: "postgres",
  password: "postgres",
  hostname: "localhost",
  database: "my_app_dev",
  stacktrace: true,
  show_sensitive_data_on_connection_error: true,
  pool_size: 10

config :logger, :console, format: "[$level] $message\n"

config :phoenix, :stacktrace_depth, 20

# 创建新项目
mix phx.new app_name

# 安装依赖
mix deps.get

# 更新依赖
mix deps.update --all

# 查看依赖
mix deps

# 编译项目
mix compile

# 创建数据库
mix ecto.create

# 删除数据库
mix ecto.drop

# 运行迁移
mix ecto.migrate

# 回滚迁移
mix ecto.rollback

# 重置数据库
mix ecto.reset

# 生成迁移
mix ecto.gen.migration add_users_table

# 生成HTML资源
mix phx.gen.html Accounts User users name:string email:string

# 生成JSON资源
mix phx.gen.json Accounts User users name:string email:string

# 生成LiveView资源
mix phx.gen.live Accounts User users name:string email:string

# 生成Context
mix phx.gen.context Accounts User users name:string email:string

# 生成控制器
mix phx.gen.controller PageController index show

# 启动服务器
mix phx.server

# 指定端口
PORT=4001 mix phx.server

# 交互式服务器
iex -S mix phx.server

// settings.json
{
  "elixirLS.dialyzerEnabled": true,
  "elixirLS.fetchDeps": true,
  "elixirLS.suggestSpecs": true,
  "editor.formatOnSave": true,
  "[elixir]": {
    "editor.defaultFormatter": "JakeBecker.elixir-ls"
  }
}

安装插件:
- Elixir
- Erlang

配置:
- Settings -> Languages & Frameworks -> Elixir
- 设置Mix path
- 设置Elixir SDK

# 手动安装Hex
mix local.hex --force

# 检查PostgreSQL状态
pg_isready

# 检查连接
psql -U postgres -h localhost

# 重置密码
sudo -u postgres psql -c "ALTER USER postgres PASSWORD 'postgres';"

# 查找占用端口的进程
lsof -i :4000

# 杀死进程
kill -9 <PID>

# 或使用其他端口
PORT=4001 mix phx.server

# 清理编译文件
mix clean

# 完全清理
mix clean --deps

# 重置依赖
rm -rf _build deps
mix deps.get