SwaggerでLaravel5のAPIドキュメントを作成するメモ - あたまんなか
新規プロジェクトのLaravel製APIにSwaggerを試してみたのでメモです swagger.io swagger-phpをcomposerで追加 $ composer require zircote/swagger-php 実装メモ github.com www.marcoraddatz.com こちら等を参考にさせていただきながらやってみます 基本情報の作成 app/swagger.phpを作成 <?php /** * @SWG\Swagger( * host="192.168.33.41/", * schemes={"http", "https"}, * @SWG\Info( * version="0.9.0", * title="api documentのテスト", * ), * ) * @SWG\Tag( * name="user", * description="ユーザーに
SwaggerでAPI通信のコードを自動生成させて楽をしよう！ - Qiita
概要 API通信処理、どんな方法で実装していますか？ クライアントアプリを開発してると何かと書く機会が多い部分ですが、アプリごとに頑張って書いていくの面倒ですよね。 同じ言語ならライブラリとして切り出せば良いですが、プラットフォームが違う場合は大抵言語も違うので、その場合は再開発する必要が出てきて辛いですよね。 そういう時はSwaggerを使うとその問題解決、あるいは軽減できるかもしれません。 今回はSwaggerを使った通信処理を自動生成する方法を紹介したいと思います。 こんな人にオススメ APIドキュメントの追従や管理がつらい プラットフォームごとに実装書くのつらい JSONをいい感じにパースするライブラリがない （もしくはあるけど実装がめんどい） APIガッツリ使うプロダクトなのに、開発開始直後でサーバー側にAPIが用意されてない 結合まで待ってたら作業進まない javaはGsonと
SpringfoxでSwaggerAPI仕様書を自動生成する (詳細設定編:1) | DevelopersIO
はじめに こんにちは。しがないOLくにきちです。 ブログ書くのが少し空いてしまっていたら、いつの間にか Springfox のバージョンが上がって 2.7.0 -> 2.8.0 になっておりました！ヽ(▽｀)ノﾜｰｲ♪ 前回のブログで設定した内容に追加をしたいと思いますので、後述します。 本ブログの構成 バージョンアップに伴う設定の追加 Swagger ドキュメントのカスタマイズ API定義（@Api） API操作定義（@ApiOperation） レスポンス定義（@ApiResponses、@ApiResponse） パラメータ定義（@ApiParam） バージョンアップに伴う設定の追加 冒頭で書きましたが、Springfox のバージョンが 2.7.0 -> 2.8.0 になりました。 このアップデートで Swagger-ui が 3系 になっているので、見た目がガラリと変わります。
composerコマンドのまとめ | TECH PROjin
composer関連でよく混乱することが多いので、まとめます。 composerとは PHPのパッケージ管理システム（LinuxのYUMやAPTみたいなもの）のことでリポジトリは「Packagist」という。 composerのインストール方法 cd 任意のディレクトリ curl -sS https://getcomposer.org/installer | php これで上記のディレクトリにcomposer.pharファイルがDLされる。上記ディレクトリまでのパス指定でcomposerが実行できるようになる。 パスを通したければ、上記ディレクトリまでのパスを通すか、すでにパスの通っている/usr/local/binディレクトリに移動するかする。 mv composer.phar /usr/local/bin/composer composerコマンドでプロジェクトを作成する。 自分で新規
Laravel5のマイグレーションでの迷走 - Qiita
関連URL MAMPにLaravel5を使える環境を作ってみる MAMPにLaravel5を使える環境を作ってみる~DB設定編~ Laravel5でFORMの作成 自分環境のブラウザアクセス http://pj_laravel5.dev:8888/ DBへテーブル作成するために実行する migrate 最初の１回、スキーマ登録すれば終わり！って言う訳にはいきません。 追加でカラムはどういれるのか？ テーブルが違うカラム追加の時、まとめてかけないのか？ 調べている途中で database/migrations/ の中に作られたマイグレーションファイルをいじってしまったことで起きた事をメモしておきます。 ＜始める前の状態＞ $ ls 2014_10_12_000000_create_users_table.php 2014_10_12_100000_create_password_resets
git submoduleについてのメモ 追加/削除/更新等
B! 70 0 0 0 Gitのsubmoduleがいつもイマイチ良くわからなくなるので 自分なりのまとめ。 レポジトリにsubmoduleの追加 submoduleのあるレポジトリをcloneする submoduleの更新 submoduleの削除 ignore = dirty Submoduleのプロトコルの変更 レポジトリにsubmoduleの追加 git submodule addで追加。 $ git submodule add [email protected]:rcmdnk/evernote_mail.git ./submodules/evernote_mail addすると.gitmoduleというファイルがまだ無い場合は作られ、その中に [submodule "submodules/evernote_mail"] path = submodules/evernote_mai
Git Submodules: コアコンセプト、ワークフロー、コツ | Atlassian Japan 公式ブログ | アトラシアン株式会社
Git を使った開発では、サブモジュールを使うことによって、他のプロジェクトを自分のコードベースに取り込めるようになります。それも、他のプロジェクトの履歴を分離しつつ、あなたのプロジェクトの履歴と同期できるようになるのです。これはベンダーライブラリ問題や依存関係問題を解決する便利な方法です。git に関してはいつもそうですが、このアプローチもかなり自己流なのでうまく出来るようになるまで少しばかり研究することをお勧めします。submodules に関する好例や詳しい説明はすでに公開されているので、ここでまた繰り返すのはやめることにします。この記事では submodule という機能を最大限に活用するのに役立つであろういくつかの面白い情報を共有したいと思います。 目次 コアコンセプト 考えられるワークフロー 初めての人向けの役に立つコツ サブモジュールを自分のフォークしたリポジトリで置き換える
Gitのサブモジュール機能を使ってプロジェクトを管理してみよう | vdeep
こんにちは、okutani(@okutani_t)です。Gitのサブモジュール（submodule）についてイマイチよく分かっていなかったので、備忘録も兼ねて記事にしてみました。 Gitのサブモジュール機能を使うと、プロジェクトで管理しているGitリポジトリとは別に、独立したリポジトリをプロジェクトに含ませることができます。 サブモジュールを含んだプロジェクトでは、プッシュ・プルをおこなってもサブモジュール側のリポジトリには影響がない、といった特徴があります。 他の特徴としては、サブモジュールはあくまで特定コミットを示すポイントを追加したディレクトリに埋め込むものです。 本記事ではGitのバージョンは1.8.5以上を対象としています。それ以下のバージョンでは使えないコマンドなどあるので注意してください。 では、さっそくGitのサブモジュールの使い方を見ていきましょう。 参考Git のサブモ
Kinectが形を変えて復活、Azure Kinectって何ができるの？
Kinectが形を変えて復活、Azure Kinectって何ができるの？2019.02.25 06:0773,982 福田ミホ Kinectは不滅です！ 本日MWCのイベントで予想通り｢HoloLens 2｣が発表されましたが、その前振りでわりとサラっと発表されたのが｢Azure Kinect｣でした。これはMicrosoft いわく｢HoloLens 2にも見られる深度センサーと複数のマイク群、カラーカメラを組み合わせ、MicrosoftのクラウドサービスAzure上のAIサービスと連動させられる｣デベロッパー向けデバイスです。 デベロッパー用なのでこれ単体で買って楽しむというタイプのものじゃないんですが、Xbox 360のアクセサリーとして登場したKinectがゲームの枠を越えていろいろハックされてたことを考えると、その可能性はかなり大きそうです。 すでにテスト利用は開始。医療用途から
沖縄県民投票「反対」が40万票超え 全体の７割超え デニー知事の得票を上回る | 沖縄タイムス＋プラス
２４日に実施された沖縄県名護市辺野古の米軍新基地建設に必要な埋め立ての賛否を問う県民投票で、埋め立てに「反対」の得票が４０万票を上回り、投票総数の７割を超えた。昨年９月の県知事選で、玉城デニー知事が獲得した約３９万６千票も上回り、新基地建設反対の民意がより明確に示された。
Laravel & Docker 環境構築 with Laradock - Qiita
はじめに Laravelをdockerを使用して環境構築します。 vagrantを立ててコマンドを１つ１つ..ってやるのは非常に面倒(初学習者だとかなり時間がかかる)なので、Laradockを使うとかなり環境構築の時間を省けます。 では、やっていきましょう。 前提 Dockerはインストールしておいてください。 https://docs.docker.com/docker-for-mac/install/ 1. 作業ディレクトリ作成 & Laradockのクローン $ mkdir laravel_app $ cd laravel_app $ mkdir hoge_project # Laravelが配置される場所 $ git clone https://github.com/LaraDock/laradock.git
Laradockでの環境構築方法２パターンを細かめに説明
社内でLaravelを使う上で、今までHomesteadを使っていたのですが、デプロイも楽にしたい、Docker触りたいっていう単純な気持ちでLaradockに手を出してみました。 個人で色々調べて手順をまとめたので、記事にしてみます。 自分が書いた社内Docker初心者向け手順書を元に書いたので、ちょっと細かめですがご了承下さい。 Laradockとは？ http://laradock.io/ Dockerを用いてlaravelの環境を作るために必要なものがほぼ全てパッケージ化されているものです。 vagrantでいうHomesteadのようなものですね。Symfony、CodeIgniterとかも普通に使えるらしいです。 Vue等も最初から使えたり、Dockerなのでimageをそのままデプロイしたりもできるので僕はHomesteadよりこっちが好きです。 また、Dockerfileや
LaravelプロジェクトのAPIをswaggerを使ってドキュメント化 - Qiita
APIのドキュメント、書くのたいへんですよね。 作っても放置されて更新されず誰も読まなくなったなんてこともあると思います。 今回はswaggerを使って、ドキュメントの生成を楽にしてみました。 swaggerとは swaggerとはAPIドキュメント生成ツールです。 http://swagger.io/ コード内に特定の記述でコメントを含めておくと、コマンド実行でAPIドキュメントを生成してくれます。 今回の環境 多くので言語でライブラリが用意されていますが、 今回はphpのLaravelフレームワークでの使い方を紹介します。 php composer Laravel4 or 5 使い方 インストール まずcomposerで必要ライブラリをインストールします。 Laravelプロジェクトのルート・ディレクトリで実行。
SCOUTER開発者ブログ
2024-04-29 CSSってどんな勉強をしたらいいの？おすすめの勉強法3選！ 文字やタブなどWebサイトのデザインを作成するマークアップ言語がCSSです。 CSSを勉強すると、おしゃれなWebサイトやかっこいいWebサイトが作れるようになります。 また、Webサイトを作るときに必要なHTMLを理解するのにも役立ちます。 CSSを勉強するならできるだけ効率よく勉強できるようになりたいですよね。 ではCSSの勉強法はどのようなものがあるのでしょうか。 CSSの勉強法は、スクール […] 2024-04-29 WEBエンジニアから見たXserverの使い勝手と評判 レンタルサーバーのおすすめサイトを見ると、大体どこでも上がってくる有料のレンタルサーバーの一つに「Xserver」があります。 このXserverとは、どのようなサーバーで、サービスにはどのようなものがあるのか。 ホームページ関連
Swaggerの概要をまとめてみた。 - Qiita
最近は API Blueprint で仕様書を書くことが多かったのですが、Swagger が世界標準になるかもしれない、ということもあり、開発の効率化を進めるためにも概要をまとめてみようと思った次第です。 Swaggerとは Swagger は RESTful APIを構築するためのオープンソースのフレームワークのことです。「Open API Initiative」という団体がRESTful APIのインターフェイスの記述をするための標準フォーマットを推進していて、その標準フォーマットがSwaggerです。Swaggerには多くの便利なツールが提供されていることもあり、多くのメリットを享受できそうです。 Swagger Spec を書いておけば自動的にドキュメント生成までしてくれ、それだけではなく、ドキュメントから実際のリクエストを投げられる優れものです。 Swaggerのツール群 ツール
サーバーのプロビジョニングをmitamae + hochoでやる方法 - Qiita
mitamaeとは Chefに比べ、よりシンプルかつ依存(chef server, cookbook, berkshelf, data_bags)が少なく実行できるItamaeというツールがあるんですが、mitamaeはmrubyを使うことでそこから更に依存(Rubyインタプリタ, RubyGems)を減らしシンプルにしたツールです。 歴史: https://k0kubun.hatenablog.com/entry/itamae-mruby https://k0kubun.hatenablog.com/entry/mitamae 何故mitamaeは便利なのか itamae sshを使うとサーバーに何も入ってない状態のまま気軽にサーバーをプロビジョニングできるため非常に便利なのですが、itamae ssh は各コマンドごとにssh越しの通信が発生してしまい非常に遅く不快なため、通の間ではo
MySQL 8.0.4におけるデフォルト認証形式の変更
Incompatible Change: The caching_sha2_password and sha256_password authentication plugins provide more secure password encryption than the mysql_native_password plugin, and caching_sha2_password provides better performance than sha256_password. Due to these superior security and performance characteristics of caching_sha2_password, it is now the preferred authentication plugin, and is also the def
MySQL8.0新機能 (caching_sha2_password 認証プラグイン) | スマートスタイル TECH BLOG
先月、MySQL8.0のGA(Generally Available)版がリリースされました。 今回はMySQL8.0で新規追加された認証プラグイン(caching_sha2_password)について確認したいと思います。 MySQL5.7までの認証プラグインには mysql_native_password がデフォルトで使用されていましたが、MySQL8.0より新たに追加された caching_sha2_password に変更されました。 SHA-256を使用した、より安全なパスワードの暗号化を提供するとともに、キャッシュを使用して同一ユーザの認証処理を高速化しようという、MySQL推奨の認証プラグインです。 caching_sha2_password 認証プラグインの確認 まずは、デフォルトに設定されている認証プラグインを確認します。 mysql> show variables l
【Docker】MySQL8.0系を使う時に発生する問題について - websandbag ブログ
新しいプロジェクトでは、過去に同じような構成をDockerで作っていればDockerfileを流用しています。 さて、 今回は、最新のMySQLイメージを使う際に発生する問題について記載していきます。 イントロダクション この記事で得られること MySQLの古いバージョンから、8.0系に移行した際に生じる問題についてわかる。 久しぶりにMySQLのイメージを使ったらエラーが起きた時の対処方法がわかる 環境 ツール 種類 バージョン Docker 18.03.1 ライブラリ 種類 バージョン laravel 5.5 状況 Laravelでアプリケーションを作っています。 Dockerで使うイメージは、ApacheとMySQLそれぞれの最新イメージを使用しています。 MySQLのDockerfileは下記です。 FROM mysql COPY ./docker-entrypoint-initd
MySQL8.0 認証方式を変更する(Laravel5) - Qiita
MySQL8.0 を初めてインストールして、 Laravelでマイグレーションを実行したときにエラーがでて罠にハマりました。 追記: 2020.04.12 PHP 7.1.16, 7.2.4 以降のバージョンから caching_sha2_password に対応するようになりましたので、この記事の設定は不要となります。 環境 MySQL8.0.x PHP < 7.2.4 エラー内容 mysql コマンドで直接データベースへログインできたのですが、Laravel マイグレーションを実行するとエラーとなりました。 $ php artisan migrate Illuminate\Database\QueryException : SQLSTATE[HY000] [2054] The server requested authentication method unknownto the cl
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
laravel プロジェクトで RuntimeException No application encryption key has been specified. - Qiita
gitのsubmoduleに変更を加えるとdiffが生じるのを無視する - Qiita
fam.cx
sourcetree で submodule を追加できないとき - Qiita
git submoduleを今風な感じで削除する - Qiita
サイオニクス、1型センサー搭載のナイトビジョン対応防水カメラ 星明かりでもカラー撮影可能
LaradockのMySQLに接続できなくてはまった話 - Qiita
GitHub - geerpm/php-docker-dev: PHP(laravel) development with docker container
OpenAPI (Swagger) 超入門 - Qiita
GitHub - sorah/hocho: Hocho: Run Itamae easily with host inventory
【速報】Microsoft、視線や指の1本1本まで認識できる「HoloLens 2」。日米同時発売