Демонстрация Elixir Phoenix, как его запустить и как развернуть через Gigalixir.
Вводные инструкции:
Существуют различные способы установки:
Убедитесь, что версии по крайней мере следующие:
erl --version
Erlang/OTP 27 …
elixir --version
Elixir 1.17.3 …
psql --version
psql (PostgreSQL) 16.4
node --version
v22.9.0
Чтобы сделать локальную настройку PostgreSQL более функциональной и более специфичной для этой демонстрации, создайте новую роль.
Имя роли — «demo_elixir_phoenix», поскольку оно соответствует имени проекта.
Пароль роли может быть надежным, поскольку это хорошая практика обеспечения безопасности.
Создайте надежный пароль, например, состоящий из 32 шестнадцатеричных цифр:
printf " %sn " $( LC_ALL=C < /dev/urandom tr -dc ' 0-9a-f ' | head -c32 )
Пример вывода:
a9ed78cd8e4aa2bd2a37ad7319899106
Чтобы сделать локальную настройку PostgreSQL более функциональной и более специфичной для этой демонстрации, создайте новую роль.
Имя роли — «demo_elixir_phoenix», поскольку оно соответствует имени проекта.
Пароль роли может быть надежным, поскольку это хорошая практика обеспечения безопасности.
Создайте надежный пароль, например, состоящий из 32 шестнадцатеричных цифр:
printf " %sn " $( LC_ALL=C < /dev/urandom tr -dc ' 0-9a-f ' | head -c32 )
Пример вывода:
a9ed78cd8e4aa2bd2a37ad7319899106
Подключитесь с помощью типичных опций PostgreSQL:
psql --username postgres postgres
Подключитесь через macOS, заварите параметры PostgreSQL:
psql --username " $USER " postgres
Используйте psql для создания роли:
postgres=# CREATE ROLE demo_elixir_phoenix WITH CREATEDB LOGIN ENCRYPTED PASSWORD 'a9ed78cd8e4aa2bd2a37ad7319899106';
Проверять:
postgres=# du demo_elixir_phoenix
List of roles
Role name | Attributes
---------------------+------------
demo_elixir_phoenix | Create DB
Обновите mix
, который является менеджером пакетов Elixir:
mix local.hex --force
Выход:
* creating …/.mix/archives/hex-2.1.1
Установите генератор новых проектов Phoenix:
mix archive.install hex phx_new
Выход:
* creating ~/.mix/archives/phx_new-1.7.14
Проверять:
mix phx.new -v
Выход:
Phoenix installer v1.7.14
Новый:
mix phx.new demo-elixir-phoenix --app demo_elixir_phoenix
cd demo-elixir-phoenix
Измените конфигурацию базы данных в файле config/dev.exs
.
Из имени пользователя и пароля по умолчанию:
username : "postgres" ,
password: "postgres" ,
В пользовательское имя пользователя и пароль:
username : "demo_elixir_phoenix" ,
password: "a9ed78cd8e4aa2bd2a37ad7319899106" ,
Бегать:
mix ecto.create
The database for DemoElixirPhoenix.Repo has been created
Выполните такое же изменение имени пользователя и пароля в файле config/test.exs
.
Если вы получили эту ошибку:
** (Mix) The task " ecto.create " could not be found
Тогда, скорее всего, вы запускаете команду не в том каталоге; убедитесь, что вы запускаете команду в базовом каталоге приложения.
Если вы получили эту ошибку:
** (Mix) The database for DemoElixirPhoenix.Repo couldn ' t be created: an exception was raised:
** (DBConnection.ConnectionError) tcp connect (localhost:5432): connection refused - :econnrefused
Тогда выполните устранение неполадок здесь:
Бегать:
mix test
Выход:
…
Finished in 0.03 seconds (0.01s async, 0.02s sync)
5 tests, 0 failures
Бегать:
mix phx.server
[info] Running DemoElixirPhoenixWeb.Endpoint with Bandit 1.5.5 at 127.0.0.1:4000 (http)
[info] Access DemoElixirPhoenixWeb.Endpoint at http://localhost:4000
[watch] build finished, watching for changes...
Rebuilding...
Done in 166ms.
Просматривать:
Вы должны увидеть страницу приветствия.
Если вы получили эту ошибку:
Error: Brunch 2+ requires node.js v4 or higher …
Upgrade node or use older brunch for old node.js: npm i -g brunch@1
Затем обновите Node, NPM и бранч:
brew update
brew uninstall node
sudo rm -rf /usr/local/lib/node_modules
brew install node --with-full-icu
npm install -g npm
npm install -g brunch
Возможно, вы захотите указать маршруты сервера:
mix phx.routes
Выход:
GET / DemoElixirPhoenixWeb.PageController :home
GET /dev/dashboard/css-:md5 Phoenix.LiveDashboard.Assets :css
GET /dev/dashboard/js-:md5 Phoenix.LiveDashboard.Assets :js
GET /dev/dashboard Phoenix.LiveDashboard.PageLive :home
GET /dev/dashboard/:page Phoenix.LiveDashboard.PageLive :page
GET /dev/dashboard/:node/:page Phoenix.LiveDashboard.PageLive :page
* /dev/mailbox Plug.Swoosh.MailboxPreview []
WS /live/websocket Phoenix.LiveView.Socket
GET /live/longpoll Phoenix.LiveView.Socket
POST /live/longpoll Phoenix.LiveView.Socket
Сгенерируйте весь код для полноценного HTML-ресурса: ecto-миграцию, ecto-модель, контроллер, представление и шаблоны.
mix phx.gen.html Account User users
name:string
email:string
Выход:
* creating lib/demo_elixir_phoenix_web/controllers/user_controller.ex
* creating lib/demo_elixir_phoenix_web/controllers/user_html/edit.html.heex
* creating lib/demo_elixir_phoenix_web/controllers/user_html/index.html.heex
* creating lib/demo_elixir_phoenix_web/controllers/user_html/new.html.heex
* creating lib/demo_elixir_phoenix_web/controllers/user_html/show.html.heex
* creating lib/demo_elixir_phoenix_web/controllers/user_html/user_form.html.heex
* creating lib/demo_elixir_phoenix_web/controllers/user_html.ex
* creating test/demo_elixir_phoenix_web/controllers/user_controller_test.exs
* creating lib/demo_elixir_phoenix/account/user.ex
* creating priv/repo/migrations/20240625211751_create_users.exs
* creating lib/demo_elixir_phoenix/account.ex
* injecting lib/demo_elixir_phoenix/account.ex
* creating test/demo_elixir_phoenix/account_test.exs
* injecting test/demo_elixir_phoenix/account_test.exs
* creating test/support/fixtures/account_fixtures.ex
* injecting test/support/fixtures/account_fixtures.ex
Мы предпочитаем, чтобы временные метки миграции располагались раньше остальных полей, поэтому редактируем миграцию:
edit priv/repo/migrations/ * _create_users.exs
Наш результат выглядит следующим образом:
defmodule DemoElixirPhoenix.Repo.Migrations.CreateUsers do
use Ecto.Migration
def change do
create table ( :users ) do
timestamps ( type: :utc_datetime )
add :name , :string
add :email , :string
end
end
end
См. файл маршрутизатора lib/demo_elixir_phoenix_web/router.ex
.
По умолчанию:
scope "/" , DemoElixirPhoenixWeb do
pipe_through :browser
get "/" , PageController , :home
end
Отредактируйте маршрутизатор:
edit lib/demo_elixir_phoenix_web/router.ex `
Добавьте пользовательский ресурс в область браузера:
scope "/" , DemoElixirPhoenixWeb do
pipe_through :browser
resources "/users" , UserController
get "/" , PageController , :home
end
Мигрировать:
mix ecto.migrate
Выход:
Generated demo_elixir_phoenix app
[info] == Running … DemoElixirPhoenix.Repo.Migrations.CreateUsers.change/0 forward
[info] create table users
[info] == Migrated … in 0.0s
Убедитесь, что пользовательские маршруты существуют:
mix phx.routes | grep users
Выход:
GET /users DemoElixirPhoenixWeb.UserController :index
GET /users/:id/edit DemoElixirPhoenixWeb.UserController :edit
GET /users/new DemoElixirPhoenixWeb.UserController :new
GET /users/:id DemoElixirPhoenixWeb.UserController :show
POST /users DemoElixirPhoenixWeb.UserController :create
PATCH /users/:id DemoElixirPhoenixWeb.UserController :update
PUT /users/:id DemoElixirPhoenixWeb.UserController :update
DELETE /users/:id DemoElixirPhoenixWeb.UserController :delete
Запустите сервер:
mix phx.server
…
[info] Running DemoElixirPhoenixWeb.Endpoint with Bandit 1.5.5 at 127.0.0.1:4000 (http)
[info] Access DemoElixirPhoenixWeb.Endpoint at http://localhost:4000
[watch] build finished, watching for changes...
Rebuilding...
Done in 152ms.
Просматривать:
Теперь вы видите целевую страницу пользователя с таким текстом, как «Список пользователей», «Имя», «Электронная почта» и т. д.
Вывод из консоли сервера:
[info] GET /users
[debug] Processing with DemoElixirPhoenixWeb.UserController.index/2
Parameters: %{}
Pipelines: [:browser]
[debug] QUERY OK source="users" db=0.4ms queue=0.5ms idle=974.7ms
SELECT u0."id", u0."name", u0."email", u0."inserted_at", u0."updated_at" FROM "users" AS u0 []
↳ DemoElixirPhoenixWeb.UserController.index/2, at: lib/demo_elixir_phoenix_web/controllers/user_controller.ex:8
[info] Sent 200 in 48ms